Axonhub

First run: Follow the setup wizard to initialize the system (create admin account, password must be at least 6 characters)

```

That's it! Now configure your first AI channel and start calling models through AxonHub.

1-click Deploy to Render

Deploy AxonHub with 1-click on Render for free.

🚀 Deployment Guide

💻 Personal Computer Deployment

Perfect for individual developers and small teams. No complex configuration required.

Quick Download & Run

1. Download the latest release from GitHub Releases

• Choose the appropriate version for your operating system:

1. Extract and run

   # Extract the downloaded file
   unzip axonhub_*.zip
   cd axonhub_*

   # Add execution permissions (only for Linux/macOS)
   chmod +x axonhub

   # Run directly - default SQLite database

   # Install AxonHub to system
   sudo ./install.sh

   # Start AxonHub service
   ./start.sh

   # Stop AxonHub service
   ./stop.sh
   

3. Access the application

   http://localhost:8090
   

---

🖥️ Server Deployment

For production environments, high availability, and enterprise deployments.

Database Support

AxonHub supports multiple databases to meet different scale deployment needs:

Configuration

AxonHub uses YAML configuration files with environment variable override support:

```yaml

Quick installation

git clone https://github.com/looplj/axonhub.git cd axonhub helm install axonhub ./deploy/helm

Production deployment

helm install axonhub ./deploy/helm -f ./deploy/helm/values-production.yaml

1. Initial Setup

1. Access Management Interface

   http://localhost:8090
   

1. Configure AI Providers

• Add API keys in the management interface
• Test connections to ensure correct configuration

3. Create Users and Roles - Set up permission management - Assign appropriate access permissions

🚀 Quick Start

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_*

Zero-Code Migration Example

Your existing code works without any changes. Just point your SDK to AxonHub:

```python 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 )

📖 Usage Guide

6. SDK Usage

For detailed SDK usage examples and code samples, please refer to the API documentation: - OpenAI API - Anthropic API - Gemini API

🛠️ Development Guide

For detailed development instructions, architecture design, and contribution guidelines, please see docs/en/development/development.md.

---

🎯 Demo

Try AxonHub live at our demo instance!

Note：The demo instance currently configures Zhipu and OpenRouter free models.

Demo Account

• Email: demo@example.com
• Password: 12345678

---

📸 Screenshots

Here are some screenshots of AxonHub in action:

System Dashboard	Channel Management	Model Price
Models	Trace Viewer	Request Monitoring

---

config.yml

server: port: 8090 name: "AxonHub" debug: false

db: dialect: "tidb" dsn: "<USER>.root:<PASSWORD>@tcp(gateway01.us-west-2.prod.aws.tidbcloud.com:4000)/axonhub?tls=true&parseTime=true&multiStatements=true&charset=utf8mb4"

log: level: "info" encoding: "json"

Environment variables:

For detailed configuration instructions, please refer to [configuration documentation](docs/en/deployment/configuration.md).

#### Docker Compose Deployment

Set environment variables

export AXONHUB_DB_DIALECT="tidb" export AXONHUB_DB_DSN="<USER>.root:<PASSWORD>@tcp(gateway01.us-west-2.prod.aws.tidbcloud.com:4000)/axonhub?tls=true&parseTime=true&multiStatements=true&charset=utf8mb4"

Set environment variables

export AXONHUB_DB_DIALECT="tidb" export AXONHUB_DB_DSN="<USER>.root:<PASSWORD>@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

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.

Use any SDK. Access any model. Zero code changes.

<a href="https://trendshift.io/repositories/16225" target="_blank"><img src="https://trendshift.io/api/badge/repositories/16225" alt="looplj%2Faxonhub | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>

</div>

🚀 API Types

---

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.

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

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: - OpenCode Integration Guide - Claude Code Integration Guide - Codex Integration Guide

---