Skip to content

Latest commit

 

History

History
598 lines (445 loc) · 31.2 KB

File metadata and controls

598 lines (445 loc) · 31.2 KB

AxonHub - オールインワンAI開発プラットフォーム

あらゆるSDKを使用。あらゆるモデルにアクセス。コード変更ゼロ。

looplj%2Faxonhub | Trendshift


❤️ スポンサー

Atlas Cloud
Atlas Cloud

Atlas Cloud は、開発者に動画生成、画像生成、LLM API へアクセスできる単一の AI API を提供するフルモーダル AI 推論プラットフォームです。複数のベンダー統合を管理する代わりに、一度接続するだけで全モーダルにわたる 300 以上の厳選されたモデルへ統一アクセスできます。

Atlas Cloud の 新しいコーディングプラン特典 で、よりお得な API アクセスをご利用ください。

無限星河 Infistar.cc
無限星河 Infistar.cc

Infistar.cc 無限星河

AxonHub × Infistar.cc 無限星河|高可用な全モデル API · 次世代 AI ゲートウェイとマルチチャネルルーティングを支援

Infistar.cc 無限星河による本プロジェクトへのご支援に感謝します!

⚡ エンタープライズ級の高い同時実行性能と安定したスケジューリング:公式価格の 1 割から利用でき、モデル倍率も公開・透明です。ミリ秒級の応答で AxonHub のインテリジェントルーティングとフェイルオーバーに最適化されています。高可用性チャネルとマルチノード冗長バックアップにより、レート制限、429、接続切断の問題を解消します;
🧠 トップモデルを全面サポート:ChatGPT、Claude、Gemini、Kimi、GLM、DeepSeek など主要モデル全般に対応し、Claude Code、Codex、OpenCode などの AI プログラミングおよび Agent 開発ツールもネイティブサポートします。
🎨 マルチモーダルと最先端エコシステムへの接続:テキスト対話やコード生成だけでなく、主要な画像生成、動画、Embedding、Rerank モデルにもワンストップで接続でき、1 つの上流チャネルでゲートウェイのマルチモーダル配信ニーズに対応します。
🎁 AxonHub ユーザー限定特典:専用リンクから登録すると、[専用付与クレジット / 初回チャージ特典]を受け取れます。すぐに利用でき、ゲートウェイのテストにも簡単に接続できます!


スポンサー 説明
七牛云 AI
七牛云 AI
七牛云 AI は七牛云(02567.HK)傘下の企業向け大規模モデル MaaS プラットフォームです。世界中の 150 以上の主要モデルをワンストップで利用でき、主要なモデルプロバイダーのプロトコルに対応しています。テキスト、画像、音声、動画、ファイル処理など、あらゆるモダリティに対応し、169 万を超える企業・開発者にサービスを提供しています。AxonHub ユーザー限定特典として、こちらのリンクから登録すると、企業ユーザーは 1,200 万トークン、開発者は 300 万トークンを無料で受け取れます。
FennoAI
FennoAI
FennoAI は、企業の研究開発チームと開発者向けに、高い安定性と性能を提供する API 中継サービスです。OpenAI および Anthropic プロトコルに対応し、Codex、Claude Code、OpenCode など主要な AI コーディングツールにシームレスに接続できます。1 日あたり数千億トークン規模の利用を支える企業向けの安定性を備え、国内外の事業主体間の決済や請求書発行にも対応しています。AxonHub ユーザー限定特典として、専用リンクからサブスクリプションを購入すると、わずか 1.99 ドルで 50 ドル相当の Coding Plan クレジットを利用できます。紹介報酬にも対応しており、友人の購入で最大 20% のコミッションを獲得できます。
Bloome
Bloome
AxonHub をローカルセットアップなしで試すなら、Bloome で: Quick start、 ブラウザやスマートフォンからワンクリックで起動でき、チームにも簡単に共有できます。


📖 プロジェクト紹介

オールインワンAI開発プラットフォーム

AxonHubは、コードを一行も変更することなくモデルプロバイダーを切り替えられるAIゲートウェイです。

OpenAI SDK、Anthropic SDK、またはその他のAI SDKを使用している場合でも、AxonHubはリクエストを透過的に変換し、サポートされているあらゆるモデルプロバイダーで動作させます。リファクタリングもSDKの入れ替えも不要 - 設定を変更するだけで完了です。

解決する課題:

  • 🔒 ベンダーロックイン - GPT-4からClaudeやGeminiへ瞬時に切り替え
  • 🔧 統合の複雑さ - 10以上のプロバイダーに対して単一のAPIフォーマット
  • 📊 オブザーバビリティの不足 - すぐに使えるリクエストトレーシング
  • 💸 コスト管理 - リアルタイムの使用量追跡と予算管理
AxonHub Architecture

コア機能

機能 提供する価値
🔄 あらゆるSDK → あらゆるモデル OpenAI SDKでClaudeを呼び出したり、Anthropic SDKでGPTを呼び出したり。コード変更不要。
🔍 完全なリクエストトレーシング スレッド対応のオブザーバビリティで完全なリクエストタイムラインを提供。デバッグを高速化。
🔐 エンタープライズRBAC きめ細かなアクセス制御、使用量クォータ、データ分離。
スマートロードバランシング 100ms未満の自動フェイルオーバー。常に最も正常なチャネルにルーティング。
💰 リアルタイムコスト追跡 リクエストごとのコスト内訳。入力、出力、キャッシュトークン - すべて追跡。

📚 ドキュメント

詳細な技術ドキュメント、APIリファレンス、アーキテクチャ設計などについては、以下をご覧ください

  • DeepWiki
  • zread

🎯 デモ

デモインスタンスでAxonHubをお試しください!

注意:デモインスタンスでは現在、ZhipuとOpenRouterの無料モデルが設定されています。

デモアカウント


⭐ 機能

📸 スクリーンショット

AxonHubの動作画面をご覧ください:

System Dashboard
システムダッシュボード
Channel Management
チャネル管理
Model Price
モデル料金
Models
モデル
Trace Viewer
トレースビューア
Request Monitoring
リクエストモニタリング

🚀 APIタイプ

APIタイプ ステータス 説明 ドキュメント
テキスト生成 ✅ 完了 会話インターフェース OpenAI API, Anthropic API, Gemini API
画像生成 ✅ 完了 画像生成 Image Generation
リランク ✅ 完了 結果のランキング 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 ✅ 完了 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

🚀 クイックスタート

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": "Hello!"}]
)

モデルの切り替えは1行変更するだけ: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

# ローカル環境ファイルを作成(イメージの digest とパスワードを置き換えてください)
umask 077
cat > .env <<'EOF'
DB_PASSWORD=replace-with-a-long-random-password
AXONHUB_IMAGE=looplj/axonhub@sha256:replace-with-axonhub-digest
POSTGRES_IMAGE=postgres@sha256:replace-with-postgres-digest
EOF

# サービスを開始
docker compose --env-file .env up -d

# ステータスを確認
docker compose ps

Helm Kubernetesデプロイ

公式Helm chartを使用して、Kubernetes上にAxonHubをデプロイします:

# クイックインストール
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 DBパスワード 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は、OpenAI Chat CompletionsとAnthropic Messages APIの両方をサポートする統合APIゲートウェイを提供します。これにより以下が可能になります:

  • OpenAI APIでAnthropicモデルを呼び出し - OpenAI SDKを使いながらClaudeモデルにアクセス
  • Anthropic APIでOpenAIモデルを呼び出し - Anthropicのネイティブフォーマットを使いながらGPTモデルにアクセス
  • Gemini APIでOpenAIモデルを呼び出し - Geminiのネイティブフォーマットを使いながらGPTモデルにアクセス
  • 自動API変換 - AxonHubがフォーマット変換を自動的に処理
  • コード変更ゼロ - 既存のOpenAIまたはAnthropicクライアントコードがそのまま動作

1. 初期セットアップ

  1. 管理画面にアクセス

    http://localhost:8090
    
  2. AIプロバイダーの設定

    • 管理画面でAPIキーを追加
    • 接続テストで正しい設定を確認
  3. ユーザーとロールの作成

    • 権限管理のセットアップ
    • 適切なアクセス権限を割り当て

2. チャネル設定

管理画面でAIプロバイダーチャネルを設定します。モデルマッピング、パラメータオーバーライド、トラブルシューティングを含むチャネル設定の詳細については、チャネル設定ガイドを参照してください。

3. モデル管理

AxonHubは、モデルアソシエーションを通じて抽象モデルを特定のチャネルおよびモデル実装にマッピングする柔軟なモデル管理システムを提供します。これにより以下が可能になります:

  • 統一モデルインターフェース - チャネル固有の名前ではなく、抽象モデルID(例:gpt-4claude-3-opus)を使用
  • インテリジェントなチャネル選択 - アソシエーションルールとロードバランシングに基づいて、最適なチャネルに自動ルーティング
  • 柔軟なマッピング戦略 - 正確なチャネル-モデルマッチング、正規表現パターン、タグベースの選択をサポート
  • 優先度ベースのフォールバック - 自動フェイルオーバーのために優先度付きの複数アソシエーションを設定

モデル管理の包括的な情報(アソシエーションタイプ、設定例、ベストプラクティスを含む)については、モデル管理ガイドを参照してください。

4. APIキーの作成

AxonHubでアプリケーションを認証するためのAPIキーを作成します。各APIキーには、以下を定義する複数のプロファイルを設定できます:

  • モデルマッピング - 完全一致または正規表現パターンを使用して、ユーザーがリクエストしたモデルを実際に利用可能なモデルに変換
  • チャネル制限 - チャネルIDまたはタグによって、APIキーが使用できるチャネルを制限
  • モデルアクセス制御 - 特定のプロファイルを通じてアクセス可能なモデルを制御
  • プロファイル切り替え - 異なるプロファイルをアクティブにすることで、動作をオンザフライで変更

APIキープロファイルの詳細(設定例、バリデーションルール、ベストプラクティスを含む)については、APIキープロファイルガイドを参照してください。

5. AIコーディングツール連携

詳細なセットアップ手順、トラブルシューティング、およびAxonHubモデルプロファイルとの組み合わせに関するヒントについては、以下の専用ガイドを参照してください:


6. SDKの使用方法

SDKの詳細な使用例とコードサンプルについては、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ファイルを参照してください。


AxonHub - オールインワンAI開発プラットフォーム、AI開発をよりシンプルに

🏠 ホームページ📚 ドキュメント🐛 問題報告

AxonHubチームが ❤️ を込めて開発