AxonHub is an all-in-one AI development platform designed to provide a unified API gateway and comprehensive tools for managing AI projects. It supports multiple AI providers, including OpenAI, Anthropic, and others, enabling seamless integration and efficient project management.
Key Features:
Unified API Gateway: AxonHub offers compatibility with OpenAI, Anthropic, and other providers, allowing developers to access various models using a single API format.
Project Management Tools: The platform provides project-based organization and an integrated playground, facilitating rapid prototyping and efficient workflow management.
Tracing Capabilities: With thread-aware tracing, AxonHub captures full request timelines, enhancing observability and aiding in faster debugging processes.
Fine-grained Permissions: Utilizing RBAC policies, AxonHub ensures precise governance of access, usage, and data segregation, supporting secure team collaboration.
Adaptive Load Balancing: This feature automatically selects optimal AI channels based on health, performance, and session consistency, ensuring efficient resource utilization.
Audience & Benefit: AxonHub is ideal for developers and enterprises engaged in AI development workflows. It streamlines processes by supporting multiple AI providers, reducing costs through efficient resource management, and enhancing observability with comprehensive tracing capabilities.
You've been invited to join the GLM Coding Plan! Enjoy full support for Claude Code, Cline, and 10+ top coding tools β starting at just $3/month. Subscribe now and grab the limited-time deal!
Ark Coding Plan supports Doubao, GLM, DeepSeek, Kimi and other models. Compatible with unlimited tools. Subscribe now for an extra 10% off β as low as $1.2/month. The more you subscribe, the more you save!
AxonHub is the AI gateway that lets you switch between model providers without changing a single line of code.
Whether you're using OpenAI SDK, Anthropic SDK, or any AI SDK, AxonHub transparently translates your requests to work with any supported model provider. No refactoring, no SDK swapsβjust change a configuration and you're done.
What it solves:
π Vendor lock-in - Switch from GPT-4 to Claude or Gemini instantly
# Download and extract (macOS ARM64 example)
curl -sSL https://github.com/looplj/axonhub/releases/latest/download/axonhub_darwin_arm64.tar.gz | tar xz
cd axonhub_*
# Run with SQLite (default)
./axonhub
# Open http://localhost:8090
# Default login: admin@axonhub.com / admin
That's it! Now configure your first AI channel and start calling models through AxonHub.
Zero-Code Migration Example
Your existing code works without any changes. Just point your SDK to AxonHub:
from openai import OpenAI
client = OpenAI(
base_url="http://localhost:8090/v1", # Point to AxonHub
api_key="your-axonhub-api-key" # Use AxonHub API key
)
# Call Claude using OpenAI SDK!
response = client.chat.completions.create(
model="claude-3-5-sonnet", # Or gpt-4, gemini-pro, deepseek-chat...
messages=[{"role": "user", "content": "Hello!"}]
)
Switch models by changing one line: model="gpt-4" β model="claude-3-5-sonnet". No SDK changes needed.
# Extract and run
unzip axonhub_*.zip
cd axonhub_*
# Set environment variables
export AXONHUB_DB_DIALECT="tidb"
export AXONHUB_DB_DSN=".root:@tcp(gateway01.us-west-2.prod.aws.tidbcloud.com:4000)/axonhub?tls=true&parseTime=true&multiStatements=true&charset=utf8mb4"
sudo ./install.sh
# Configuration file check
axonhub config check
# Start service
# For simplicity, we recommend managing AxonHub with the helper scripts:
# Start
./start.sh
# Stop
./stop.sh
π Usage Guide
Unified API Overview
AxonHub provides a unified API gateway that supports both OpenAI Chat Completions and Anthropic Messages APIs. This means you can:
Use OpenAI API to call Anthropic models - Keep using your OpenAI SDK while accessing Claude models
Use Anthropic API to call OpenAI models - Use Anthropic's native API format with GPT models
Use Gemini API to call OpenAI models - Use Gemini's native API format with GPT models
Automatic API translation - AxonHub handles format conversion automatically
Zero code changes - Your existing OpenAI or Anthropic client code continues to work
1. Initial Setup
Access Management Interface
http://localhost:8090
Configure AI Providers
Add API keys in the management interface
Test connections to ensure correct configuration
Create Users and Roles
Set up permission management
Assign appropriate access permissions
2. Channel Configuration
Configure AI provider channels in the management interface. For detailed information on channel configuration, including model mappings, parameter overrides, and troubleshooting, see the Channel Configuration Guide.
3. Model Management
AxonHub provides a flexible model management system that supports mapping abstract models to specific channels and model implementations through Model Associations. This enables:
Unified Model Interface - Use abstract model IDs (e.g., gpt-4, claude-3-opus) instead of channel-specific names
Intelligent Channel Selection - Automatically route requests to optimal channels based on association rules and load balancing
Flexible Mapping Strategies - Support for precise channel-model matching, regex patterns, and tag-based selection
Priority-based Fallback - Configure multiple associations with priorities for automatic failover
For comprehensive information on model management, including association types, configuration examples, and best practices, see the Model Management Guide.
4. Create API Keys
Create API keys to authenticate your applications with AxonHub. Each API key can be configured with multiple profiles that define:
Model Mappings - Transform user-requested models to actual available models using exact match or regex patterns
Channel Restrictions - Limit which channels an API key can use by channel IDs or tags
Model Access Control - Control which models are accessible through a specific profile
Profile Switching - Change behavior on-the-fly by activating different profiles
For detailed information on API key profiles, including configuration examples, validation rules, and best practices, see the API Key Profile Guide.
5. AI Coding Tools Integration
See the dedicated guides for detailed setup steps, troubleshooting, and tips on combining these tools with AxonHub model profiles:
