grokroute
v2.1.4
Published
🔥 GrokRoute — free AI router for Grok Build. Auto-fallback: Agnes > Groq > Zhipu > Laguna > Ollama
Maintainers
Readme
🔥 GrokRoute
GrokRoute — бесплатный роутер для Grok Build. Автоматически перенаправляет запросы от Grok Build на доступные бесплатные/собственные провайдеры.
🚀 Установка
npm install -g grokrouteЗатем настройте Grok Build на использование локального прокси:
grokroute install # Создаёт ~/.grok/config.tomlИ запускайте:
grokroute # Запускает прокси → нажмите ENTER для grok💸 Поддерживаемые провайдеры
| Провайдер | Требуется ключ | Скорость | Описание | |-----------|---------------|----------|----------| | Agnes AI | Да | Быстро | Бесплатные кредиты на старте | | Groq | Да | Очень быстро | LPU-ускорение, быстрые ответы | | Zhipu AI | Да | Средняя | Бесплатные GLM-модели | | Laguna | Да | Средняя | Кодинг-ориентированные модели | | Ollama | Нет | Зависит от ПК | Локальные модели |
Прокси пробует провайдеры в порядке: Agnes → Groq → Zhipu → Laguna → Ollama.
Получение ключей
- Agnes AI: https://apihub.agnes-ai.com
- Groq: https://console.groq.com
- Zhipu AI: https://z.ai/model-api
- Laguna: https://poolside.ai
📋 Команды
| Команда | Что делает |
|---------|------------|
| grokroute / gfree / groute | Запустить прокси и интерактивный режим |
| grokroute admin | Открыть админку в браузере |
| grokroute install | Настроить Grok Build на прокси |
| grokroute status | Проверить статус прокси |
| grokroute uninstall | Удалить настройки GrokRoute |
| grokroute help | Справка |
🔧 Как это работает
grok (в терминале)
│
▼
┌──────────────────┐
│ GrokRoute Proxy │ ← http://localhost:8083
│ (Python/Node.js) │
└────────┬─────────┘
│
┌─────┴──────┐
▼ ▼
Agnes/Groq/… Ollama
(через API) (локально)GrokRoute выступает в роли OpenAI-совместимого прокси: Grok Build отправляет запросы на http://127.0.0.1:8083, а прокси роутит их на выбранного провайдера.
️ Ручная настройка
Файл конфигурации прокси находится в ~/.grokroute/grokroute-config.json:
{
"provider": "auto",
"agnes_api_key": "",
"groq_api_key": "",
"zhipu_api_key": "",
"laguna_api_key": "",
"ollama_model": "qwen2.5-coder:7b"
}При первом запуске прокси автоматически создаст шаблон из grokroute-config.example.json. Ключи проще ввести через админку: http://127.0.0.1:8083/admin.
📦 Установка без npm
Если нет Node.js/npm, можно запустить напрямую через Python:
git clone https://github.com/wxstdo-boop/grokroute.git
cd grokroute
python grokroute-proxy.pyИли на Windows запустите install.ps1 от имени администратора, а затем start.bat.
❓ Часто задаваемые вопросы
Это реально бесплатно?
Ollama работает локально и не требует ключа. Остальные провайдеры дают бесплатные кредиты при регистрации или имеют свободные тиры.
Grok Build бесплатный?
Grok Build — open source инструмент. Платной была только подписка на xAI API. GrokRoute заменяет платный API на альтернативные источники.
Хочу вернуть как было?
grokroute uninstall📜 Лицензия
MIT — делай что хочешь.
