❤️ 赞助商

📖 项目介绍

All-in-one AI 开发平台

AxonHub 是 AI 网关，让你无需改动一行代码即可切换模型供应商。

无论你使用的是 OpenAI SDK、Anthropic SDK 还是任何 AI SDK，AxonHub 都会透明地将你的请求转换为与任何支持的模型供应商兼容的格式。无需重构，无需更换 SDK——只需更改配置即可。

它解决了什么问题：

• 🔒 供应商锁定 - 从 GPT-4 瞬间切换到 Claude 或 Gemini
• 🔧 集成复杂性 - 一个 API 格式对接 10+ 供应商
• 📊 可观测性缺口 - 开箱即用的完整请求追踪
• 💸 成本控制 - 实时用量追踪和预算管理

核心特性 Core Features

📚 文档 | Documentation

文档索引 | Documentation Index

• 📑 完整文档索引 - 所有文档导航和快速查找

DeepWiki

详细的技术文档、API 参考、架构设计等内容，可以访问

🎯 演示 | Demo

在我们的 演示实例 上体验 AxonHub！

注意：演示网站目前配置了 Zhipu 和 OpenRouter 的免费模型。

演示账号 | Demo Account

• 邮箱 Email: demo@example.com
• 密码 Password: 12345678

⭐ 特性 | Features

📸 截图 | Screenshots

以下是 AxonHub 的实际运行截图：

🚀 API 类型 | API Types

🤖 支持的提供商 | Supported Providers

🚀 快速开始 | Quick Start

30 秒本地启动 | 30-Second Local Start

# 下载并解压（以 macOS ARM64 为例）
curl -sSL https://github.com/looplj/axonhub/releases/latest/download/axonhub_darwin_arm64.tar.gz | tar xz
cd axonhub_*

# 使用 SQLite 运行（默认）
./axonhub

# 打开 http://localhost:8090
# 首次运行：按照初始化向导设置系统（创建管理员账号，密码至少需要 6 位）

就这样！现在配置你的第一个 AI 渠道，开始通过 AxonHub 调用模型。

零代码迁移示例 | Zero-Code Migration Example

你的现有代码无需任何改动。 只需将 SDK 指向 AxonHub：

from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:8090/v1",  # 指向 AxonHub
    api_key="your-axonhub-api-key"        # 使用 AxonHub API 密钥
)

# 用 OpenAI SDK 调用 Claude！
response = client.chat.completions.create(
    model="claude-3-5-sonnet",  # 或 gpt-4、gemini-pro、deepseek-chat...
    messages=[{"role": "user", "content": "Hello!"}]
)

切换模型只需改一行：model="gpt-4" → model="claude-3-5-sonnet"。无需改动 SDK。

🚀 部署指南 | Deployment Guide

💻 个人电脑部署 | Personal Computer Deployment

适合个人开发者和小团队使用，无需复杂配置。

快速下载运行 | Quick Download & Run

1. 下载最新版本 从 GitHub Releases

   • 选择适合您操作系统的版本：

2. 解压并运行

   # 解压下载的文件
   unzip axonhub_*.zip
   cd axonhub_*
   
   # 添加执行权限 (仅限 Linux/macOS)
   chmod +x axonhub
   
   # 直接运行 - 默认使用 SQLite 数据库
   # 安装 AxonHub 到系统
   ./install.sh
   
   # 启动 AxonHub 服务
   ./start.sh
   
   # 停止 AxonHub 服务
   ./stop.sh
   

3. 访问应用

   http://localhost:8090
   

🖥️ 服务器部署 | Server Deployment

适用于生产环境、高可用性和企业级部署。

数据库支持 | Database Support

AxonHub 支持多种数据库，满足不同规模的部署需求：

配置文件 | Configuration

AxonHub 使用 YAML 配置文件，支持环境变量覆盖：

# 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"

环境变量：

AXONHUB_SERVER_PORT=8090
AXONHUB_DB_DIALECT="tidb"
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"
AXONHUB_LOG_LEVEL=info

详细配置说明请参考 配置文档。

Docker Compose 部署

# 克隆项目
git clone https://github.com/looplj/axonhub.git
cd axonhub

# 设置环境变量
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"

# 启动服务
docker-compose up -d

# 查看状态
docker-compose ps

Helm Kubernetes 部署 | Helm Kubernetes Deployment

使用官方 Helm Chart 在 Kubernetes 上部署 AxonHub：

# 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

# Access AxonHub
kubectl port-forward svc/axonhub 8090:8090
# Visit http://localhost:8090

关键配置选项：

有关详细配置和故障排查，请参阅 Helm Chart 文档。

虚拟机部署 | Virtual Machine Deployment

下载最新版本从 GitHub Releases

# 克隆项目
git clone https://github.com/looplj/axonhub.git
cd axonhub

# 设置环境变量
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

# 配置文件检查
axonhub config check

# 使用管理脚本管理 AxonHub

# 启动
./start.sh

# 停止
./stop.sh

📖 使用指南 | Usage Guide

1. 初始化设置 | Initial Setup

1. 访问管理界面

   http://localhost:8090
   

2. 配置 AI 提供商

   • 在管理界面中添加 API 密钥
   • 测试连接确保配置正确

3. 创建用户和角色

   • 设置权限管理
   • 分配适当的访问权限

2. Channel 配置 | Channel Configuration

在管理界面中配置 AI 提供商渠道。关于渠道配置的详细信息，包括模型映射、参数覆盖和故障排除，请参阅 渠道配置指南。

3. 模型管理 | Model Management

AxonHub 提供灵活的模型管理系统，支持通过模型关联将抽象模型映射到特定渠道和模型实现。这使您能够：

• 统一模型接口 - 使用抽象模型 ID（如 gpt-4、claude-3-opus）替代渠道特定的名称
• 智能渠道选择 - 基于关联规则和负载均衡自动将请求路由到最优渠道
• 灵活的映射策略 - 支持精确的渠道-模型匹配、正则表达式模式和基于标签的选择
• 基于优先级的回退 - 配置多个具有优先级的关联以实现自动故障转移

关于模型管理的全面信息，包括关联类型、配置示例和最佳实践，请参阅 模型管理指南。

4. 创建 API Key | Create API Keys

创建 API 密钥以验证您的应用程序与 AxonHub 的连接。每个 API 密钥可以配置多个配置文件（Profile），用于定义：

• 模型映射 - 使用精确匹配或正则表达式模式将用户请求的模型转换为实际可用的模型
• 渠道限制 - 通过渠道 ID 或标签限制 API 密钥可以使用的渠道
• 模型访问控制 - 控制特定配置文件可以访问的模型
• 配置文件切换 - 通过激活不同的配置文件即时更改行为

关于 API 密钥配置文件的详细信息，包括配置示例、验证规则和最佳实践，请参阅 API 密钥配置文件指南。

5. AI 编程工具集成 | AI Coding Tools Integration

关于如何在 OpenCode、Claude Code 与 Claude Codex 中配置与 AxonHub 的集成、排查常见问题以及结合模型配置文件工作流的最佳实践，请参阅专门的集成指南：

• OpenCode 集成指南
• Claude Code 集成指南
• Codex 集成指南

这些文档提供了环境变量示例、Codex 配置模板、模型配置文件说明以及工作流示例，帮助您快速完成接入。

6. 使用 SDK | SDK Usage

详细的 SDK 使用示例和代码示例，请参阅 API 文档：

• OpenAI API
• Anthropic API
• Gemini API

🛠️ 开发指南

详细的开发说明、架构设计和贡献指南，请查看 docs/zh/development/development.md。

🤝 致谢 | Acknowledgments

• 🙏 musistudio/llms - LLM 转换框架，灵感来源
• 🎨 satnaing/shadcn-admin - 管理界面模板
• 🔧 99designs/gqlgen - GraphQL 代码生成
• 🌐 gin-gonic/gin - HTTP 框架
• 🗄️ ent/ent - ORM 框架
• 🔧 air-verse/air - 自动重载 Go 服务
• ☁️ render - 免费云部署平台，用于部署 demo
• 🗄️ tidbcloud - Serverless 数据库平台，用于部署 demo

📄 许可证 | License

本项目采用多种许可证授权（Apache-2.0 和 LGPL-3.0）。详见 LICENSE 文件了解详细的项目授权说明与条款。