# axonhub | Loop | Knowledge Base | Instagit

⚡️ Open-source AI Gateway — Use any SDK to call 100+ LLMs. Built-in failover, load balancing, cost control & end-to-end tracing.

GitHub Stars: 2.2k

Repository: https://github.com/looplj/axonhub

---

## Articles

### [How to Optimize LLM Request Timeout and Performance Tuning in AxonHub](/looplj/axonhub/how-to-optimize-llm-request-timeout-and-performance-tuning)

Optimize LLM request timeout and performance tuning in AxonHub by configuring hierarchical timeouts in conf.go. Set HTTP, orchestration, and provider-specific limits for improved workload latency.

- Tags: performance
- Published: 2026-03-06

### [How to Scale AxonHub Horizontally with Kubernetes Helm Charts](/looplj/axonhub/how-to-scale-axonhub-horizontally-with-kubernetes-helm-charts)

Scale AxonHub horizontally using Kubernetes Helm charts and the looplj/axonhub repository. Configure replica counts or enable autoscaling for efficient resource management.

- Tags: how-to-guide
- Published: 2026-03-06

### [How to Debug Request Failures Using Trace and Request Logs in AxonHub](/looplj/axonhub/how-to-debug-request-failures-using-trace-and-request-logs)

Debug request failures in AxonHub with AH Trace and Request IDs. Learn how to use these headers and logs for efficient end-to-end troubleshooting in your repository.

- Tags: how-to-guide
- Published: 2026-03-06

### [How to Manage API Key Rotation and Disabled Key Recovery in AxonHub](/looplj/axonhub/how-to-manage-api-key-rotation-and-disabled-key-recovery)

Learn to manage AxonHub API key rotation and disabled key recovery. Securely rotate keys, switch channels, disable old ones, and recover accidentally disabled keys with ease.

- Tags: how-to-guide
- Published: 2026-03-06

### [How to Configure Cache Settings with Redis for Production Deployments in AxonHub](/looplj/axonhub/how-to-configure-cache-settings-with-redis-for-production-deployments)

Learn to configure Redis cache settings for AxonHub production deployments. Set environment variables and initialize your store for optimal performance. Explore the Redis cache setup.

- Tags: how-to-guide
- Published: 2026-03-06

### [How to Implement Custom LLM Transformers for Provider Compatibility in AxonHub](/looplj/axonhub/how-to-implement-custom-llm-transformers-for-provider-compatibility)

Learn to implement custom LLM transformers in AxonHub. Create structs with TransformRequest and TransformResponse methods for seamless provider compatibility. Get started today!

- Tags: how-to-guide
- Published: 2026-03-06

### [How to Handle Provider Quota Limits with Automatic Fallback in AxonHub](/looplj/axonhub/how-to-handle-provider-quota-limits-with-automatic-fallback)

Learn how AxonHub automatically handles provider quota limits by failing over to alternative endpoints. Isolates quota pools per model for seamless operation.

- Tags: how-to-guide
- Published: 2026-03-06

### [How to Migrate Existing Applications to Use AxonHub Without Code Changes](/looplj/axonhub/how-to-migrate-existing-applications-to-use-axonhub-without-code-changes)

Migrate existing AI apps to AxonHub with zero code changes. Update your SDK base URL and API key thanks to OpenAI-compatible REST endpoints. Get started today.

- Tags: migration-guide
- Published: 2026-03-06

### [How Channel Health Probing and Auto-Disable Work in AxonHub](/looplj/axonhub/how-does-channel-health-probing-and-auto-disable-work)

Learn how AxonHub uses channel health probing and auto disable to protect LLM providers. Discover circuit breaker style testing and permanent removal of failing channels or API keys.

- Tags: internals
- Published: 2026-03-06

### [How to Use the AxonHub GraphQL API for Management Operations](/looplj/axonhub/how-to-use-the-graphql-api-for-management-operations)

Manage channels, API keys, users, and more with the AxonHub GraphQL API. Discover type-safe, RBAC-protected operations implemented via gqlgen in this guide.

- Tags: how-to-guide
- Published: 2026-03-06

### [How to Configure CORS Settings for Cross-Origin Requests in AxonHub](/looplj/axonhub/how-to-configure-cors-settings-for-cross-origin-requests)

Learn how to configure CORS settings for cross-origin requests in AxonHub. Easily enable and validate CORS with simple server configuration for seamless API integration.

- Tags: how-to-guide
- Published: 2026-03-06

### [How the Model Circuit Breaker Prevents Cascading Failures in AxonHub](/looplj/axonhub/how-does-the-model-circuit-breaker-prevent-cascading-failures)

Learn how the model circuit breaker in AxonHub stops cascading failures. It isolates failing LLM providers by adjusting load balancing to prevent error propagation.

- Tags: internals
- Published: 2026-03-06

### [How to Deploy AxonHub Using Docker Compose for Production](/looplj/axonhub/how-to-deploy-axonhub-using-docker-compose-for-production)

Deploy AxonHub in production easily with Docker Compose. Clone the repo, set environment variables, and run docker-compose up -d for a seamless API gateway deployment.

- Tags: how-to-guide
- Published: 2026-03-06

### [How to Use API Key Profiles for Model Access Control and Restrictions in AxonHub](/looplj/axonhub/how-to-use-api-key-profiles-for-model-access-control-and-restrictions)

Secure your AxonHub models with API Key Profiles Limit access, whitelist models, filter channels, and enforce quotas without code changes. Master fine-grained control.

- Tags: how-to-guide
- Published: 2026-03-06

### [How Model Associations Enable Intelligent Channel Selection in AxonHub](/looplj/axonhub/how-do-model-associations-enable-intelligent-channel-selection)

AxonHub's model associations route requests intelligently using rules and regex for dynamic channel selection. Explore how this eliminates hard-coded provider logic.

- Tags: deep-dive
- Published: 2026-03-06

### [How to Configure Different Database Backends in AxonHub: TiDB, PostgreSQL, MySQL, and SQLite](/looplj/axonhub/how-to-configure-different-database-backends)

Easily configure AxonHub with various database backends like TiDB PostgreSQL MySQL and SQLite using config.yml or environment variables No code changes needed for flexible data management

- Tags: how-to-guide
- Published: 2026-03-06

### [How AxonHub Implements Fine-Grained RBAC Permission System with Scope-Based Access Control](/looplj/axonhub/how-does-the-rbac-permission-system-work-with-fine-grained-access-control)

Explore AxonHubs fine-grained RBAC permission system. Learn how scope-based access control guards every operation with precise action and resource definitions.

- Tags: deep-dive
- Published: 2026-03-06

### [How to Configure Real-Time Cost Tracking and Per-Request Cost Breakdown in AxonHub](/looplj/axonhub/how-to-configure-real-time-cost-tracking-and-per-request-cost-breakdown)

Learn to configure real-time cost tracking and per-request cost breakdown in AxonHub. Map token usage to pricing for granular cost insights and optimize your LLM expenses.

- Tags: how-to-guide
- Published: 2026-03-06

### [How Request Tracing Works with Thread-Aware Observability in AxonHub](/looplj/axonhub/how-does-request-tracing-work-with-thread-aware-observability)

Learn how AxonHub uses request tracing and thread-aware observability to correlate data across threads and services. Understand trace and thread ID propagation for enhanced debugging.

- Tags: internals
- Published: 2026-03-06

### [How to Set Up OAuth Integration with Codex and Claude Code in AxonHub](/looplj/axonhub/how-to-set-up-oauth-integration-with-codex-and-claude-code)

Discover how to set up OAuth integration with Codex and Claude Code. AxonHub uses PKCE-based flows for secure access token exchange. Get started now.

- Tags: how-to-guide
- Published: 2026-03-06

### [How AxonHub Implements Load Balancing Across Multiple API Keys](/looplj/axonhub/how-does-axonhub-handle-load-balancing-across-multiple-api-keys)

Learn how AxonHub implements load balancing across multiple API keys using round-robin rotation in the authentication provider to balance traffic and avoid rate limits.

- Tags: internals
- Published: 2026-03-06

### [How to Implement Request Overrides with Templates in Channel Configuration](/looplj/axonhub/how-to-implement-request-overrides-with-templates-in-channel-configuration)

Learn to implement request overrides with templates in channel configuration. AxonHub lets you dynamically customize JSON payloads and HTTP headers at runtime before sending to LLM providers.

- Tags: how-to-guide
- Published: 2026-03-06

### [How to Configure Channel Model Mappings for Automatic Model Name Rewriting in AxonHub](/looplj/axonhub/how-to-configure-channel-model-mappings-for-automatic-model-name-rewriting)

Learn how to configure channel model mappings in AxonHub for automatic model name rewriting. Streamline your provider requests by rewriting and restoring model names seamlessly.

- Tags: how-to-guide
- Published: 2026-03-06

### [How AxonHub Implements Any SDK to Any Model Translation](/looplj/axonhub/how-does-axonhubs-any-sdk-to-any-model-translation-work)

Discover how AxonHub enables Any SDK to Any Model translation by normalizing requests to a generic agent Message format and using provider specific conversion layers. Unlock seamless LLM integration.

- Tags: how-to-guide
- Published: 2026-03-06