---

注意

1. 本项目由个人维护，作者不提供任何担保，也不对因使用本项目而产生的风险承担任何责任，请您谨慎评估。
2. 本项目的核心范围不包括2api（订阅转API）。如果您需要该功能，请考虑其他专注于2api的开源项目。

---

📖 项目介绍

多合一AI开发平台

AxonHub是AI网关，让您无需修改一行代码即可在不同模型提供商之间切换。

无论您使用的是OpenAI SDK、Anthropic SDK，还是任何其他AI SDK，AxonHub都能透明地将您的请求转换为与任何受支持的模型提供商兼容的格式。无需重构代码，也无需更换SDK——只需更改配置即可完成切换。

它解决了以下问题：

• 🔒 供应商锁定 - 可以立即从GPT-4切换到Claude或Gemini
• 🔧 集成复杂性 - 一种API格式适用于10多家提供商
• 📊 可观测性缺失 - 开箱即用的完整请求追踪
• 💸 成本控制 - 实时使用情况跟踪和预算管理

核心功能

功能	您将获得
🔄 任意SDK → 任意模型	使用OpenAI SDK调用Claude，或使用Anthropic SDK调用GPT。无需更改代码。
🔍 完整请求追踪	具有线程感知的完整请求时间线。更快地进行调试。
🔐 企业级RBAC	细粒度的访问控制、使用配额和数据隔离。
⚡ 智能负载均衡	自动故障转移，耗时不到100毫秒。始终路由到最健康的通道。
💰 实时成本跟踪	每个请求的成本明细。输入、输出、缓存令牌——全部被跟踪。

---

📚 文档

有关详细的技术文档、API参考、架构设计等信息，请访问：

• 
• [![zread](https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjE1QzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTZgNS42MDAxSDQuOTYxNTYgNS4zMTM1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjMzk5OSDHMi4yNDE1NiNDMS44ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAyLjI0MDFWNC45NjE1QzEuNjAxNTYgNS42MDAxIDEuODg4MSAxLjYwMDE1NiAyLjI0MDFWNC45NjE1QzEuNjAxNTYgNS42MDAxIDEuODg4MSAxLjYwMDE1NiAyLjI0MDFWNC45NjE1QzEuNjAxNTYgNS42MDAxIDEuODg4MSAxLjYwMDE1NiAyLjI0MDFWNC45NjE1QzEuNjAxNTYgNS42MDAxIDEuODg4MSAxLjYwMDE1NiAyLjI0MDFWNC45NjE1QzEuNjAxNTYgNS42MDAxIDEuODg4MSAxLjYwMDE1NiAyLjI0MDFWNC45NjE1QzEuNjAxNTYgNS42MDAxIDEuODg4MSAxLjYwMDE1NiAyLjI0MDFWNC45NjE1QzEuNjAxNTYgNS42MDAxIDEuODg4MSAxLjYwMDE1NiAyLjI0MDFWNC45NjE1QzEuNjAxNTYgNS42MDAxIDEuODg4MSAxLjYwMDE1NiAyLjI0MDFWNC45NjE1QzEuNjAxNTY......

📸 截图

以下是 AxonHub 运行时的一些截图：

系统仪表盘	频道管理	模型价格
模型列表	追踪查看器	请求监控

---

🚀 API 类型

API 类型	状态	描述	文档
文本生成	✅ 完成	对话式接口	OpenAI API, Anthropic API, Gemini API
图像生成	✅ 完成	图像生成	图像生成
重排序	✅ 完成	结果排序	Rerank API
嵌入	✅ 完成	向量嵌入生成	Embedding API
实时	📝 待办	实时对话功能	-

---

🤖 支持的提供商

提供商	状态	支持的模型	兼容的 API
OpenAI	✅ 完成	GPT-4, GPT-4o, GPT-5, 等.	OpenAI, Anthropic, Gemini, Embedding, Image Generation
Anthropic	✅ 完成	Claude 3.5, Claude 3.0, 等.	OpenAI, Anthropic, Gemini
Zhipu AI	✅ 完成	GLM-4.5, GLM-4.5-air, 等.	OpenAI, Anthropic, Gemini
Moonshot AI (Kimi)	✅ 完成	kimi-k2, 等.	OpenAI, Anthropic, Gemini
DeepSeek	✅ 完成	DeepSeek-V3.1, 等.	OpenAI, Anthropic, Gemini
ByteDance Doubao	✅ 完成	doubao-1.6, 等.	OpenAI, Anthropic, Gemini, Image Generation
Gemini	✅ 完成	Gemini 2.5, 等.	OpenAI, Anthropic, Gemini, Image Generation
Fireworks	✅ 完成	MiniMax-M2.5, GLM-5, Kimi K2.5, 等.	OpenAI
Jina AI	✅ 完成	嵌入、重排序等	Jina Embedding, Jina Rerank
OpenRouter	✅ 完成	各种模型	OpenAI, Anthropic, Gemini, Image Generation
ZAI	✅ 完成	-	Image Generation
AWS Bedrock	🔄 测试	Claude 在 AWS 上	OpenAI, Anthropic, Gemini
Google Cloud	🔄 测试	Claude 在 GCP 上	OpenAI, Anthropic, Gemini
NanoGPT	✅ 完成	各种模型、图像生成	OpenAI, Anthropic, Gemini, Image Generation

---

🚀 快速入门

30 秒本地启动

# 下载并解压（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": "你好！"}]
)

只需更改一行代码即可切换模型：model="gpt-4" → model="claude-3-5-sonnet"。无需修改 SDK。

一键部署到 Render

在 Render 上一键免费部署 AxonHub。

---

🚀 部署指南

💻 个人电脑部署

非常适合个人开发者和小型团队。无需复杂的配置。

快速下载与运行

1. 从 GitHub Releases 下载最新版本：

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

2. 解压并运行

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

3. 访问应用

   http://localhost:8090
   

---

🖥️ 服务器部署

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

数据库支持

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

数据库	支持版本	推荐场景	自动迁移	链接
TiDB Cloud	Starter	无服务器、免费层级、自动扩展	✅ 支持	TiDB Cloud
TiDB Cloud	Dedicated	分布式部署、大规模	✅ 支持	TiDB Cloud
TiDB	V8.0+	分布式部署、大规模	✅ 支持	TiDB
Neon DB	-	无服务器、免费层级、自动扩展	✅ 支持	Neon DB
PostgreSQL	15+	生产环境、中大型部署	✅ 支持	PostgreSQL
MySQL	8.0+	生产环境、中大型部署	✅ 支持	MySQL
SQLite	3.0+	开发环境、小型部署	✅ 支持	SQLite

配置

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 Chart 将 AxonHub 部署到 Kubernetes 上：

# 快速安装
git clone https://github.com/looplj/axonhub.git
cd axonhub
helm install axonhub ./deploy/helm

# 生产环境部署
helm install axonhub ./deploy/helm -f ./deploy/helm/values-production.yaml

# 访问 AxonHub
kubectl port-forward svc/axonhub 8090:8090
# 访问 http://localhost:8090

关键配置选项：

参数	描述	默认值
axonhub.replicaCount	副本数	1
axonhub.dbPassword	数据库密码	axonhub_password
postgresql.enabled	内嵌 PostgreSQL	true
ingress.enabled	启用 Ingress	false
persistence.enabled	数据持久化	false

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

虚拟机部署

从 GitHub Releases 下载最新版本：

# 解压并运行
unzip axonhub_*.zip
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

---

📖 使用指南

统一 API 概览

AxonHub 提供了一个统一的 API 网关，同时支持 OpenAI Chat Completions 和 Anthropic Messages API。这意味着您可以：

• 使用 OpenAI API 调用 Anthropic 模型 - 在继续使用 OpenAI SDK 的同时访问 Claude 模型
• 使用 Anthropic API 调用 OpenAI 模型 - 使用 Anthropic 的原生 API 格式调用 GPT 模型
• 使用 Gemini API 调用 OpenAI 模型 - 使用 Gemini 的原生 API 格式调用 GPT 模型
• 自动 API 转换 - AxonHub 会自动处理格式转换
• 无需更改代码 - 您现有的 OpenAI 或 Anthropic 客户端代码可以继续正常工作

1. 初始设置

1. 访问管理界面

   http://localhost:8090
   

2. 配置 AI 提供商

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

3. 创建用户和角色

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

2. 通道配置

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

3. 模型管理

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

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

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

4. 创建 API 密钥

创建 API 密钥以对您的应用程序进行 AxonHub 身份验证。每个 API 密钥都可以配置多个配置文件，用于定义：

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

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

5. AI 编码工具集成

请参阅专用指南，了解详细的设置步骤、故障排除以及如何将这些工具与 AxonHub 模型配置文件结合使用的技巧：

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

---

6. SDK 使用

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

• OpenAI API
• Anthropic API
• Gemini API

🛠️ 开发指南

有关详细的开发说明、架构设计和贡献指南，请参阅 docs/en/development/development.md。

---

🤝 致谢

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

---

📄 许可证

本项目采用多重许可证（Apache-2.0 和 LGPL-3.0）授权。有关详细的许可概述和条款，请参阅 LICENSE 文件。

---

# 1. 下载并解压最新版本
curl -sSL https://github.com/looplj/axonhub/releases/latest/download/axonhub_darwin_arm64.tar.gz | tar xz

# 2. 进入目录
cd axonhub_*

# 3. 运行程序 (默认使用 SQLite 存储配置)
./axonhub

docker run -d \
  --name axonhub \
  -p 8090:8090 \
  -v axonhub_data:/app/data \
  ghcr.io/looplj/axonhub:latest

from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:8090/v1",  # 指向 AxonHub 地址
    api_key="your-axonhub-api-key"        # 使用在 AxonHub 后台创建的 API Key
)

# 直接调用 Claude 模型，无需更换 SDK
response = client.chat.completions.create(
    model="claude-3-5-sonnet",  # 可随意切换为 gpt-4, gemini-pro, deepseek-chat 等
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)