Install AxonHub using Winget - wingetCollections
Go back Packages AxonHub Use this command to install AxonHub:
winget install --id=looplj.AxonHub -e Copy WinGet command to clipboard AxonHub Description
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.
README
AxonHub - All-in-one AI 开发平台
任意 SDK、任意模型、零代码改动
❤️ 赞助商
<a href="https://lj.s.gy/oZl7Vd">
<picture>
<img src="docs/sponsors/atlas-cloud-logomark-black.svg" height="50" />
</picture>
<strong>Atlas Cloud</strong>
</a>
<p align="left">
<a href="https://lj.s.gy/oZl7Vd">Atlas Cloud</a> 是一个全模态 AI 推理平台,为开发者提供统一的 AI API 来访问视频生成、图像生成和 LLM API。无需管理多个供应商集成,只需连接一次即可统一访问 300+ 精选模型,涵盖所有模态。
</p>
<p align="left">
查看 Atlas Cloud 的 <a href="https://lj.s.gy/jknt2V">全新 Coding plan 促销</a>,获取更经济实惠的 API 访问方案。
</p>
<a href="https://lj.s.gy/jKk8uU">
<img src="https://raw.githubusercontent.com/Krill-ai-org/krill-ai-static/refs/heads/main/krill-logo/Eng/250x150.png" height="50" />
<strong>Krill AI</strong>
</a>
<p align="left">
感谢 Krill AI 赞助本项目。Krill 提供 GPT、Claude、Gemini 及多款国产模型的官方稳定极速 API 中转服务,支持企业级定制、报销开票和 7x16 小时专属技术支持。其独家适配的 WebSocket 连接方式可带来更快的首字速度。
</p>
<p align="left">
使用 <a href="https://lj.s.gy/jKk8uU">此链接</a> 注册,并在充值时填写 AxonHub 优惠码,首次购买 Codex 套餐可享 77 折优惠。
</p>
赞助商
详情
<a href="https://bloome.im/app?ref=MjgMzmCY&utm_medium=github&utm_source=looplj-axonhub-ivor-202606">
<img src="docs/sponsors/bloome.png" height="90" />
<strong>Bloome</strong>
</a>
想试用 AxonHub,但不想在本地配置环境?可以在 Bloome 上运行:
<a href="https://bloome.im/app?ref=MjgMzmCY&utm_medium=github&utm_source=looplj-axonhub-ivor-202606">快速使用</a>,
通过浏览器或手机一键启动,也可以轻松分享给你的团队。
📖 项目介绍
All-in-one AI 开发平台
AxonHub 是 AI 网关,让你无需改动一行代码即可切换模型供应商。
无论你使用的是 OpenAI SDK、Anthropic SDK 还是任何 AI SDK,AxonHub 都会透明地将你的请求转换为与任何支持的模型供应商兼容的格式。无需重构,无需更换 SDK——只需更改配置即可。
1.0.0-beta6
Copy WinGet command to clipboard 1.0.0-beta5
Copy WinGet command to clipboard 1.0.0-beta4
Copy WinGet command to clipboard 1.0.0-beta3
Copy WinGet command to clipboard 1.0.0-beta2
Copy WinGet command to clipboard 1.0.0-beta1
Copy WinGet command to clipboard 0.9.43
Copy WinGet command to clipboard 0.9.42
Copy WinGet command to clipboard 0.9.40
Copy WinGet command to clipboard 0.9.38
Copy WinGet command to clipboard
🔒 供应商锁定 - 从 GPT-4 瞬间切换到 Claude 或 Gemini
🔧 集成复杂性 - 一个 API 格式对接 10+ 供应商
📊 可观测性缺口 - 开箱即用的完整请求追踪
💸 成本控制 - 实时用量追踪和预算管理
核心特性 Core Features 特性 你能获得什么 🔄 任意 SDK → 任意模型 用 OpenAI SDK 调用 Claude,或用 Anthropic SDK 调用 GPT。零代码改动。 🔍 完整请求追踪 线程级可观测性的完整请求时间线。更快定位问题。 🔐 企业级 RBAC 细粒度访问控制、用量配额和数据隔离。 ⚡ 智能负载均衡 <100ms 自动故障转移。始终路由到最健康的渠道。 💰 实时成本追踪 每次请求的成本明细。输入、输出、缓存 Token——全部追踪。
📚 文档 | Documentation
文档索引 | Documentation Index
DeepWiki 详细的技术文档、API 参考、架构设计等内容,可以访问
🎯 演示 | Demo 注意 :演示网站目前配置了 Zhipu 和 OpenRouter 的免费模型。
演示账号 | Demo Account
⭐ 特性 | Features
📸 截图 | Screenshots <a href="docs/screenshots/axonhub-dashboard.png">
<img src="docs/screenshots/axonhub-dashboard.png" width="250" />
</a>
系统仪表板
<a href="docs/screenshots/axonhub-channels.png">
<img src="docs/screenshots/axonhub-channels.png" width="250" />
</a>
渠道管理
<a href="docs/screenshots/axonhub-model-price.png">
<img src="docs/screenshots/axonhub-model-price.png" width="250" />
</a>
模型价格
<a href="docs/screenshots/axonhub-models.png">
<img src="docs/screenshots/axonhub-models.png" width="250" />
</a>
模型
<a href="docs/screenshots/axonhub-trace.png">
<img src="docs/screenshots/axonhub-trace.png" width="250" />
</a>
追踪查看
<a href="docs/screenshots/axonhub-requests.png">
<img src="docs/screenshots/axonhub-requests.png" width="250" />
</a>
请求监控
🚀 API 类型 | API Types
🤖 支持的提供商 | Supported Providers 提供商 Provider 状态 Status 支持模型 Models 兼容 API OpenAI ✅ 已完成 GPT-4, GPT-4o, GPT-5 等 OpenAI, Anthropic, Gemini, Embedding, Image Generation Anthropic ✅ 已完成 Claude 3.5, Claude 3.0 等 OpenAI, Anthropic, Gemini 智谱 AI (Zhipu) ✅ 已完成 GLM-4.5, GLM-4.5-air 等 OpenAI, Anthropic, Gemini 月之暗面 (Moonshot) ✅ 已完成 kimi-k2 等 OpenAI, Anthropic, Gemini DeepSeek ✅ 已完成 DeepSeek-V3.1 等 OpenAI, Anthropic, Gemini 字节跳动豆包 ✅ 已完成 doubao-1.6 等 OpenAI, Anthropic, Gemini, Image Generation Gemini ✅ 已完成 Gemini 2.5 等 OpenAI, Anthropic, Gemini, Image Generation Jina AI ✅ 已完成 Embeddings, Reranker 等 Jina Embedding, Jina Rerank OpenRouter ✅ 已完成 多种模型 OpenAI, Anthropic, Gemini, Image Generation ZAI ✅ 已完成 - Image Generation AWS Bedrock 🔄 测试中 Claude on AWS OpenAI, Anthropic, Gemini Google Cloud 🔄 测试中 Claude on GCP OpenAI, Anthropic, Gemini NanoGPT ✅ 已完成 多种模型、图像生成 OpenAI, Anthropic, Gemini, Image Generation
🚀 快速开始 | 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
下载最新版本 从 GitHub Releases
解压并运行
# 解压下载的文件
unzip axonhub_*.zip
cd axonhub_*
# 添加执行权限 (仅限 Linux/macOS)
chmod +x axonhub
# 直接运行 - 默认使用 SQLite 数据库
# 安装 AxonHub 到系统
./install.sh
# 启动 AxonHub 服务
./start.sh
# 停止 AxonHub 服务
./stop.sh
访问应用
http://localhost:8090
🖥️ 服务器部署 | Server Deployment
数据库支持 | Database Support AxonHub 支持多种数据库,满足不同规模的部署需求:
数据库 支持版本 推荐场景 自动迁移 链接 SQLite 3.0+ 开发环境、小型部署 ✅ 支持 SQLite TiDB Cloud Starter Serverless, Free tier, Auto Scale ✅ 支持 TiDB Cloud TiDB Cloud Dedicated 分布式部署、大规模 ✅ 支持 TiDB Cloud TiDB V8.0+ 分布式部署、大规模 ✅ 支持 TiDB Neon DB - Serverless, Free tier, Auto Scale ✅ 支持 Neon DB PostgreSQL 15+ 生产环境、中大型部署 ✅ 支持 PostgreSQL MySQL 8.0+ 生产环境、中大型部署 ✅ 支持 MySQL
配置文件 | Configuration AxonHub 使用 YAML 配置文件,支持环境变量覆盖:
# config.yml
server:
port: 8090
name: "AxonHub"
debug: false
db:
dialect: "tidb"
dsn: ".root:@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=".root:@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=".root:@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
参数 描述 默认 axonhub.replicaCount副本数 1axonhub.dbPassword数据库密码 axonhub_passwordpostgresql.enabled是否启用内嵌 PostgreSQL trueingress.enabled是否启用 Ingress falsepersistence.enabled是否启用持久化存储 false
虚拟机部署 | Virtual Machine Deployment # 克隆项目
git clone https://github.com/looplj/axonhub.git
cd axonhub
# 设置环境变量
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
# 配置文件检查
axonhub config check
# 使用管理脚本管理 AxonHub
# 启动
./start.sh
# 停止
./stop.sh
📖 使用指南 | Usage Guide
1. 初始化设置 | Initial Setup
访问管理界面
http://localhost:8090
配置 AI 提供商
在管理界面中添加 API 密钥
测试连接确保配置正确
创建用户和角色
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 密钥可以使用的渠道
模型访问控制 - 控制特定配置文件可以访问的模型
配置文件切换 - 通过激活不同的配置文件即时更改行为
5. AI 编程工具集成 | AI Coding Tools Integration 关于如何在 OpenCode、Claude Code 与 Claude Codex 中配置与 AxonHub 的集成、排查常见问题以及结合模型配置文件工作流的最佳实践,请参阅专门的集成指南:
这些文档提供了环境变量示例、Codex 配置模板、模型配置文件说明以及工作流示例,帮助您快速完成接入。
6. 使用 SDK | SDK Usage 详细的 SDK 使用示例和代码示例,请参阅 API 文档:
🛠️ 开发指南
🤝 致谢 | Acknowledgments
📄 许可证 | License 本项目采用多种许可证授权(Apache-2.0 和 LGPL-3.0)。详见 LICENSE 文件了解详细的项目授权说明与条款。
AxonHub - All-in-one AI 开发平台,让 AI 开发更简单
🏠 官网 • 📚 文档 • 🐛 问题反馈
Built with ❤️ by the AxonHub team