注意

1. 本项目为个人维护，作者不对使用风险作任何保证，请审慎评估。
2. 本项目核心范围不包括 2api（订阅转 API）；如有此类需求，建议使用其他专注于 2api 的开源项目。

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

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

它解决了什么问题：

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

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

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

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

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

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

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

系统仪表板	渠道管理	模型价格
模型	追踪查看	请求监控

# 下载并解压（以 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 调用模型。

你的现有代码无需任何改动。 只需将 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。

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

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
   

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

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

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

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

使用官方 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 文档。

下载最新版本从 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

1. 访问管理界面

   http://localhost:8090
   

2. 配置 AI 提供商

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

3. 创建用户和角色

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

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

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

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

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

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

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

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

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

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

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

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

• OpenAI API
• Anthropic API
• Gemini API

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

• 🙏 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