इस प्रोजेक्ट के बारे में
AI Switch स्वयं को उन लोगों के लिए “स्थानीय AI API Key हब” बताता है जो कई AI कोडिंग टूल्स में रिले या बहु-विक्रेता API कुंजियाँ संभालते हैं। इसका दावा है कि एक बार कुंजी बदलने पर वह हर इंस्टॉल किए गए टूल में प्रसारित होनी चाहिए, और एक खराब कुंजी पूरे स्टैक को नीचे नहीं गिरानी चाहिए। यह खुद को चैट क्लांट के बजाय manage / probe / push उपयोगिता के रूप में प्रस्तुत करता है।
यह क्या करता है
- Key store: खोज, टैग, बैच enable/disable/delete, बैच आयात, “MetaAPI” merge और dedupe के साथ बहु-विक्रेता कुंजी तालिका, ताकि कुंजियाँ एक जगह रहें, कई कॉन्फ़िग फ़ाइलों में हाथ से संपादित न करनी पड़ें।
- Health और endpoint जाँच: मॉडल-स्तरीय endpoint detection (Chat, Responses, Messages, Gemini) के सा शेड्यूल्ड health monitoring, प्रति-विक्रेता और प्रति-मॉडल क्रियाओं के साथ विक्रेता-समूहित quality checks, पठनीय त्रुटियाँ, अनुकूली जाँच अंतराल, वैकल्पिक auto-disable और primary/backup failover, साथ ही मृत कुंजियों का archive।
- Safe sync: केवल हाल की सफल health और endpoint जाँच वाले मॉडल बैकएंड में पुश किए जाते हैं; लिखने से पहले sync preview दिखाया जाता है, और जो टूल इंस्टॉल नहीं हैं उनमें कभी नहीं लिखा जाता।
README बताता है कि quality checks प्रति मॉडल चार छोटे अनुरोध भेजते हैं और provider कोटा खा सकते हैं, और endpoint समर्थन प्रति मॉडल पहचाना जाता है — automatic मोड सत्यापित endpoints का उपयोग करता है जबकि manual मोड आपको पहचाने गए फ़ॉर्मैट में से चुनने देता है।
समर्थित बैकएंड
OpenClaw (openclaw.json, auth profiles, models), OpenCode (auth.json, opencode.jsonc), Claude Code (settings.json, ~/.claude.json), Codex CLI (auth.json, config.toml plus Responses health), Cline / Aider / Continue.dev (IDE और CLI configs), और Hermes Agent, QwenCode, Kimi Code तथा TRAE Work जैसा docs/backends.md में प्रलेखित है। Backends पृष्ठ प्रत्येक को Not installed, Stopped (syncable) या Running के रूप में बताता है। सूचीबद्ध endpoint families हैं openai_chat (OpenAI, DeepSeek, OpenRouter, Groq, Moonshot, Qwen और समान), anthropic, gemini और openai_responses। सुविा सूची में 26+ अंतर्निहित providers plus custom OpenAI-compatible endpoints, और contribution guide के साथ drop-in backend adapters का भी उल्लेख है।
Interface और extras
dashboard, backends sync status, health monitor, non-blocking task center, light और dark themes, और English / Simplified Chinese / Traditional Chinese localization वाला web UI। इसमें यह भी शामिल है: vendor types (Public / Relay / Raw key) model catalog और check-in में filtering के साथ, archiving (छिपाएँ, health checks से बाहर रखें, बाद में पुनर््थापित करें), check-in URLs, budgets, encrypted profile export, diagnostics pack, downstream routes और desktop packages।
Install और run
- Windows x64, macOS Intel, macOS Apple Silicon और Linux x64 के लिए Releases builds: extract करें और 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 launcher: npx github:kingkate2009-droid/ai-switch, या global install।
- Docker: docker compose up -d।
एक प्रलेखित “3-minute loop” है: vendor और key जोड़ें (या smart import), health check पास होने दें, पहले preview के सा backends में push करें, फिर OpenCode / Codex / Claude Code से hi भेजें।
Configuration और security
डेटा ~/.ai-switch/ai-switch.db पर और usage ~/.ai-switch/usage.json पर संग्रहीत होता है; डिफ़ॉल्ट port 8787 (AI_SWITCH_PORT) है। README कहता है कि कुंजियाँ केवल ~/.ai-switch/ के अंतर्गत रहती हैं और यह directory कभी commit नहीं की जानी चाहिए, तथा LAN exposure के लिए Settings में वैकल्पिक access token का उल्लेख करता है। मौजूदा data.json state एक बार आयात होता है, rollback के लिए legacy फ़ाइलें .legacy suffix के अंतर्गत रखी जाती हैं। कॉन्फ़िर किया गया port fixed है: यदि वह occupied है तो startup स्पष्ट त्रुटि के साथ बाहर निकल जाता है। State storage transactional SQLite है।
Stack और license: Python + Flask, vanilla JS, SQLite, pluggable adapters; Apache 2.0। Documentation में quickstart, Codex connectivity troubleshooting page, backends matrix और adapter contribution guide शामिल हैं।
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.