このプロジェクトについて
AI Switchは、リレーやマルチベンダーのAPIキーを複数のAIコーディングツールの間で取り扱う人向けの「ローカルAI APIキーハブ」です。キーを一度変更するだけですべてのインストール済ツールに反映され、壊れたキーがスタック全体を停止させないことを目指しています。チャットクライアントではなく、管理/プローブ/プッシュユーティリティとして位置づけられています。
主な機能
- キーストア: 複数ベンダー対応のキーテーブル。検索、タグ、一括有効化/無効化/削除、一括インポート、「MetaAPI」マージと重複排除をサポート。キーを一处に集約し、手動での設定ファイル編集を不要にします。
- ヘルスエンドポイントチェック: モデルレベルのエンドポイント検出(Chat、Responses、Messages、Gemini)付きスケジュール監視。ベンダーグループ別品質チェック、パーベンダー/パーモデルアクション、読みやすいエラー表示、適応的チェック間隔、オプションの自動無効化とプライマリ/バックアップフェールオーバー、デッドキーのアーカイブ。
- 安全な同期: 最近の成功したヘルスエンドポイントチェックを持つモデルのみをバックエンドにプッシュ。書き込み前に同期プレビューを表示し、未インストールのツールには絶対に書き込みません。
品質チェックはモデルごとに4件の短いリクエストを送信し、プロバイダのクォータを消費する可能性があります。エンドポイントサポートはモデルごとに検出され、自動モードは検証済みエンドポイントを使用し、手動モードでは検出されたフォーマットから選択できます。
対応バックエンド
OpenClaw(openclaw.json、認証プロファイル、モデル)、OpenCode(auth.json、opencode.jsonc)、Claude Code(settings.json、~/.claude.json)、Codex CLI(auth.json、config.toml、Responsesヘルス)、Cline/Aider/Continue.dev(IDEおよびCLI設定)、Hermes Agent、QwenCode、Kimi Code、TRAE。各バックエンドは「未インストール」「停止中(同期可能)」「実行中」のいずれかで表示されます。
エンドポイントファミリー: openai_chat(OpenAI、DeepSeek、OpenRouter、Groq、Moonshot、Qwenなど)、anthropic、gemini、openai_responses。
インターフェースと追加機能
ダッシュボード、バックエンド同期ステータス、ヘルスモニター、ノンブロッキングタスクセンターを備えたWeb UI。ライト/ダークテーマ、英語/簡体字中国語/繁体字中国語のローカライゼーション。ベンダータイプ(Public/Relay/Rawキー)のフィルタリング、アーカイブ機能、チェックインURL、予算管理、暗号化プロフィールエクスポート、診断パック、ダウンストリームルート、デスクトップパッケージ。
インストールと実行
- Windows x64、macOS Intel、macOS Apple Silicon、Linux x64のリリースビルド: 解凍してai-switch/start.bat/start.shを実行し、http://127.0.0.1:8787を開く。
- ソースから: git clone、pip install -r requirements.txt、python3 run.py(Python 3.9+)。
- npm/npxランチャー: npx github:kingkate2009-droid/ai-switch、またはグローバルインストール。
- Docker: docker compose up -d。
構成とセキュリティ
データは~/.ai-switch/ai-switch.dbに、使用状況は~/.ai-switch/usage.jsonに保存されます。デフォルトポートは8787(AI_SWITCH_PORT)。キーは~/.ai-switch/ディレクトリ内でのみ保持され、このディレクトリはコミットすべきではありません。オプションのアクセストークン設定でLAN公開が可能です。既存のdata.json状態は1回限りのインポートされ、廃止用ファイルは.legacy接尾辞付きで保管されます。
スタックとライセンス: Python + Flask、バニラJS、SQLite、プラグイン可能アダプタ。Apache 2.0。ドキュメントにはクイックスタート、Codex接続トラブルシューティングページ、バックエンドマトリックス、アダプタ貢献ガイドが含まれます。
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.