freegate 0.6.0

package/.env.example

@@ -0,0 +1,7 @@
+# Copy to .env and fill in your keys. Only keys marked free:true are required.
+PROVIDER_GROQ_APIKEY=
+PROVIDER_MISTRAL_APIKEY=
+PROVIDER_GEMINI_APIKEY=
+PROVIDER_NIM_APIKEY=
+PROVIDER_ZAI_APIKEY=
+PROVIDER_OPENROUTER_APIKEY=

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sid
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,191 @@
+# Freegate
+
+[![CI](https://github.com/Artur21101965/davil-cod/actions/workflows/ci.yml/badge.svg)](https://github.com/Artur21101965/davil-cod/actions)
+[![Docker Hub](https://img.shields.io/docker/pulls/nik951751/davil-cod.svg)](https://hub.docker.com/r/nik951751/davil-cod)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![npm](https://img.shields.io/npm/v/davil-cod.svg)](https://www.npmjs.com/package/davil-cod)
+[![GitHub stars](https://img.shields.io/github/stars/Artur21101965/davil-cod?style=social)](https://github.com/Artur21101965/davil-cod)
+
+**[Русская версия](README.ru.md) · Russian version**
+
+## Why pay for LLMs when free ones exist?
+
+Your AI agent, bot, or script talks to a single OpenAI-compatible endpoint.
+Behind it, Freegate automatically routes requests across **25 free models**
+from Groq, Mistral, Gemini, NVIDIA NIM, OpenRouter, ZAI, Cerebras, DeepSeek
+and local models. If one provider goes down, gets overloaded, or burns its
+daily limit — the request **instantly falls through to the next one**. You
+never see "rate limit", and you never pay.
+
+**Result:** full LLM access for everyday work at the price of **$0**.
+
+![Freegate Dashboard](assets/dashboard.png)
+
+## Features
+
+| | |
+|---|---|
+| 🔀 **Auto-failover** | 25 providers in one chain. Provider down? The next one answers. |
+| 🤖 **Self-managing models** | Auto-discovers new free models, tests them, adds working ones, disables dead ones — every 6h. |
+| 🏷️ **Model categories** | reasoning / coding / general / vision / local — the right model for the right job. |
+| 🖼️ **Two-stage vision** | Screenshot → vision model reads it → coding model answers the fix. |
+| 💰 **Free** | Free models only. The dashboard shows each provider's remaining limit. |
+| ⚡ **Smart routing** | Picks the fastest, most stable provider for every request. |
+| 🛡️ **Reliability** | Circuit breaker, request queue, auto-disable of dead providers, watchdog. |
+| 📊 **Dashboard** | Status, speed, limits, history, tokens, RPM chart. |
+| 💾 **Disk cache** | Repeat prompts don't consume limits at all. |
+| 🔌 **Compatible** | Any OpenAI client: opencode, Cursor, your scripts. |
+
+## Quick start — 30 seconds
+
+```bash
+npx davil-cod init -i     # wizard: password + each provider's key
+npx davil-cod start       # proxy on http://localhost:4000
+npx davil-cod test        # verify everything works
+```
+
+Dashboard: `http://localhost:4000/?key=your_password`
+
+Or via Docker:
+
+```bash
+docker run -d --name davil-cod -p 4000:4000 \
+  -e PROVIDER_GROQ_APIKEY=... \
+  -e PROVIDER_MISTRAL_APIKEY=... \
+  -e AUTH=your-secret-key \
+  nik951751/davil-cod
+```
+
+### Connect any OpenAI client
+
+| Field | Value |
+|-------|-------|
+| Base URL | `http://localhost:4000/v1` |
+| API Key | your password from `init` |
+| Model | `tier-s` (fast) / `tier-splus` (powerful) |
+
+Example for opencode (`~/.config/opencode/opencode.jsonc`):
+
+```jsonc
+{
+  "provider": {
+    "free-proxy": {
+      "npm": "@ai-sdk/openai-compatible",
+      "name": "Freegate",
+      "options": {
+        "baseURL": "http://localhost:4000/v1",
+        "apiKey": "your-secret-key-here"
+      },
+      "models": {
+        "tier-splus": { "name": "Freegate (Best)", "input": ["text"] },
+        "tier-s": { "name": "Freegate (Fast)", "input": ["text"] }
+      }
+    }
+  }
+}
+```
+
+## Supported providers
+
+| Provider | Models | Where to get key | Limit/day |
+|----------|--------|------------------|-----------|
+| Groq | gpt-oss-120b, qwen-27b, allam-2-7b, compound | console.groq.com | 1000 |
+| Mistral | codestral, small | console.mistral.ai | 500K tok |
+| NVIDIA NIM | llama, vision | build.nvidia.com | 40 |
+| Gemini | gemini-3.6-flash, vision | aistudio.google.com | 1500 |
+| OpenRouter | cohere-north, glm, nemotron, ox-alpha, dots-3, lfm, laguna | openrouter.ai | 50-100 |
+| ZAI | glm-4.7-flash | open.bigmodel.cn | 1000 |
+| Cerebras | gpt-oss-120b, gemma-4-31b | cloud.cerebras.ai | 1000 |
+| DeepSeek | deepseek-v4-flash, vision | platform.deepseek.com | 1000 |
+| Local | Ollama, LM Studio | — | unlimited |
+
+**New free models are discovered, tested, and added automatically** — no need
+to watch for new releases. The model manager runs every 6 hours.
+
+> The catalog is extensible: add a model to `providers.json` and it joins the pool.
+> Providers unavailable to your key (404) are auto-disabled.
+
+## How it works
+
+1. A request arrives at `/v1/chat/completions` (OpenAI format).
+2. Freegate picks the best provider: healthy, under limit, fastest today.
+3. If it fails — instantly tries the next one in the chain.
+4. The response returns in the same format — the client never notices.
+
+## Development
+
+```bash
+npm test          # unit tests (17)
+node server.js    # run from source
+```
+
+## Configuration
+
+**Keys** — only in `.env` (never committed):
+
+```bash
+PROVIDER_GROQ_APIKEY=...       # Groq
+PROVIDER_MISTRAL_APIKEY=...    # Mistral
+PROVIDER_GEMINI_APIKEY=...     # Gemini
+PROVIDER_NIM_APIKEY=...        # NVIDIA NIM
+PROVIDER_OPENROUTER_APIKEY=... # OpenRouter
+PROVIDER_ZAI_APIKEY=...        # ZAI
+```
+
+**Server settings** — in `config.json` or env:
+
+| Setting | Env | Default |
+|---------|-----|---------|
+| Port | `PORT` | `4000` |
+| Password | `AUTH` | empty (no auth) |
+| Rate limit/min | `config.json → rateLimit` | 100/min |
+
+**Providers** — catalog in `providers.json` (18 models). Add your own:
+put it in `config.json` → `providers` (same format as `providers.json`).
+
+## CLI commands
+
+```bash
+npx davil-cod init              # create config
+npx davil-cod init -i           # interactive wizard (keys, password)
+npx davil-cod start             # start proxy
+npx davil-cod status            # diagnostics: providers, limits, errors
+npx davil-cod test              # verify it works
+npx davil-cod install-service   # autostart at boot
+npx davil-cod dashboard         # open dashboard
+```
+
+## FAQ
+
+**Is this legal?** Yes. You connect **your own** free provider keys — you just
+get a single reliable gateway to all of them.
+
+**How much does it cost?** $0. Only the free-tier limits of the providers.
+
+**Which models are fastest?** The proxy measures and picks. Currently leading:
+Qwen (Groq, ~300ms) and cohere-north (OpenRouter).
+
+**Can I add my own provider?** Yes — add it to `config.json` or `providers.json`.
+
+**Is it only for opencode?** No. Any OpenAI-compatible client
+(see `examples/` — Cursor, Claude Code, scripts).
+
+## Tools
+
+### Shorts generator — `tools/generate_shorts.py`
+Free vertical video (9:16) generation via **MiniMax H3** (video + sound from
+one prompt) or **Wan 2.1**. Runs through Hugging Face online demos — GPU in
+the cloud, no install.
+
+```bash
+cd tools
+uv venv .venv && uv pip install --python .venv/bin/python -r requirements.txt
+export HF_TOKEN=hf_xxx            # free: huggingface.co → settings/tokens
+./.venv/bin/python generate_shorts.py "Cozy morning scene, warm light" --format 9:16 --duration 5
+```
+
+Prompt catalog: `tools/prompts.md`.
+
+## License
+
+MIT

package/README.ru.md

@@ -0,0 +1,191 @@
+# Freegate
+
+[![CI](https://github.com/Artur21101965/davil-cod/actions/workflows/ci.yml/badge.svg)](https://github.com/Artur21101965/davil-cod/actions)
+[![Docker Hub](https://img.shields.io/docker/pulls/nik951751/davil-cod.svg)](https://hub.docker.com/r/nik951751/davil-cod)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![npm](https://img.shields.io/npm/v/davil-cod.svg)](https://www.npmjs.com/package/davil-cod)
+
+**English version: [README.md](README.md)**
+
+## Зачем платить за LLM, когда есть бесплатные?
+
+Твой AI-агент, бот или скрипт использует один OpenAI-совместимый endpoint.
+За ним Freegate автоматически распределяет запросы между **25 бесплатными
+моделями** — Groq, Mistral, Gemini, NVIDIA NIM, OpenRouter, ZAI, Cerebras,
+DeepSeek и локальные модели. Если один провайдер упал, перегружен или сжёг
+дневной лимит — запрос **мгновенно уходит на следующий**. Ты никогда не
+видишь «rate limit», и никогда не платишь.
+
+**Результат:** полноценный LLM-доступ для повседневной работы по цене $0.
+
+![Дашборд Freegate](assets/dashboard.png)
+
+## Возможности
+
+| | |
+|---|---|
+| 🔀 **Автопереключение** | 25 провайдеров в одной цепочке. Провайдер упал? Следующий уже отвечает. |
+| 🤖 **Автоуправление моделями** | Сам находит новые бесплатные модели, тестирует, добавляет рабочие, отключает мёртвые — каждые 6 часов. |
+| 🏷️ **Категории моделей** | reasoning / coding / general / vision / local — правильная модель для каждой задачи. |
+| 🖼️ **Vision-конвейер** | Скриншот → vision-модель читает → кодинг-модель отвечает на вопрос. |
+| 💰 **Бесплатно** | Только free-модели. Дашборд показывает остаток лимита каждого провайдера. |
+| ⚡ **Умный выбор** | Прокси сам находит самый быстрый и стабильный провайдер для каждого запроса. |
+| 🛡️ **Надёжность** | Circuit breaker, очередь запросов, автоотключение мёртвых провайдеров, watchdog. |
+| 📊 **Дашборд** | Статус, скорость, лимиты, история, токены, RPM-график. |
+| 💾 **Кэш на диске** | Повторные промпты не тратят лимиты вообще. |
+| 🔌 **Совместимость** | Любой OpenAI-клиент: opencode, Cursor, ChatGPT-аналоги, твои скрипты. |
+
+## Быстрый старт — 30 секунд
+
+```bash
+npx davil-cod init -i     # мастер спросит: пароль + ключи каждого провайдера
+npx davil-cod start       # прокси на http://localhost:4000
+npx davil-cod test        # проверить, что всё работает
+```
+
+Дашборд: `http://localhost:4000/?key=твой_пароль`
+
+Или через Docker:
+
+```bash
+docker run -d --name davil-cod -p 4000:4000 \
+  -e PROVIDER_GROQ_APIKEY=... \
+  -e PROVIDER_MISTRAL_APIKEY=... \
+  -e AUTH=your-secret-key \
+  nik951751/davil-cod
+```
+
+### Подключение к любому OpenAI-клиенту
+
+| Поле | Значение |
+|------|----------|
+| Base URL | `http://localhost:4000/v1` |
+| API Key | твой пароль из `init` |
+| Модель | `tier-s` (быстрая) / `tier-splus` (мощная) |
+
+Пример для opencode (`~/.config/opencode/opencode.jsonc`):
+
+```jsonc
+{
+  "provider": {
+    "free-proxy": {
+      "npm": "@ai-sdk/openai-compatible",
+      "name": "Freegate",
+      "options": {
+        "baseURL": "http://localhost:4000/v1",
+        "apiKey": "your-secret-key-here"
+      },
+      "models": {
+        "tier-splus": { "name": "Freegate (Best)", "input": ["text"] },
+        "tier-s": { "name": "Freegate (Fast)", "input": ["text"] }
+      }
+    }
+  }
+}
+```
+
+## Поддерживаемые провайдеры
+
+| Провайдер | Модели | Где ключ | Лимит/день |
+|-----------|--------|----------|------------|
+| Groq | gpt-oss-120b, qwen-27b, allam-2-7b, compound | console.groq.com | 1000 |
+| Mistral | codestral, small | console.mistral.ai | 500K ток |
+| NVIDIA NIM | llama, vision | build.nvidia.com | 40 |
+| Gemini | gemini-3.6-flash, vision | aistudio.google.com | 1500 |
+| OpenRouter | cohere-north, glm, nemotron, ox-alpha, dots-3, lfm, laguna | openrouter.ai | 50-100 |
+| ZAI | glm-4.7-flash | open.bigmodel.cn | 1000 |
+| Cerebras | gpt-oss-120b, gemma-4-31b | cloud.cerebras.ai | 1000 |
+| DeepSeek | deepseek-v4-flash, vision | platform.deepseek.com | 1000 |
+| Локальные | Ollama, LM Studio | — | безлимит |
+
+**Новые бесплатные модели находятся, тестируются и добавляются автоматически**
+— не нужно следить за релизами. Менеджер моделей работает каждые 6 часов.
+
+> Каталог расширяемый: добавь модель в `providers.json` — и она попадёт в пул.
+> Провайдеры, недоступные твоему ключу (404), отключаются автоматически.
+
+## Как это работает
+
+1. Приходит запрос на `/v1/chat/completions` (формат OpenAI).
+2. Freegate выбирает лучший провайдер: здоровый, под лимитом, самый быстрый сегодня.
+3. Если запрос не прошёл — мгновенно пробует следующий из цепочки.
+4. Ответ возвращается клиенту в том же формате — клиент ничего не замечает.
+
+## Разработка
+
+```bash
+npm test          # unit-тесты (17 шт.)
+node server.js    # запуск из исходников
+```
+
+## Конфигурация
+
+**Ключи** — только в `.env` (не в git):
+
+```bash
+PROVIDER_GROQ_APIKEY=...       # Groq
+PROVIDER_MISTRAL_APIKEY=...    # Mistral
+PROVIDER_GEMINI_APIKEY=...     # Gemini
+PROVIDER_NIM_APIKEY=...        # NVIDIA NIM
+PROVIDER_OPENROUTER_APIKEY=... # OpenRouter
+PROVIDER_ZAI_APIKEY=...        # ZAI
+```
+
+**Параметры сервера** — в `config.json` или env:
+
+| Параметр | Env | По умолчанию |
+|----------|-----|--------------|
+| Порт | `PORT` | `4000` |
+| Пароль | `AUTH` | пусто (нет auth) |
+| Лимит запросов/мин | `config.json → rateLimit` | 100/мин |
+
+**Провайдеры** — каталог в `providers.json` (18 моделей). Добавить свой:
+впиши его в `config.json` → `providers` (формат как в `providers.json`).
+
+## Команды CLI
+
+```bash
+npx davil-cod init              # создать конфиг
+npx davil-cod init -i           # интерактивный мастер (ключи, пароль)
+npx davil-cod start             # запустить прокси
+npx davil-cod status            # диагностика: провайдеры, лимиты, ошибки
+npx davil-cod test              # проверить, что работает
+npx davil-cod install-service   # автозапуск при старте системы
+npx davil-cod dashboard         # открыть дашборд
+```
+
+## FAQ
+
+**Это законно?** Да. Ты подключаешь **свои** бесплатные ключи провайдеров —
+просто получаешь единый надёжный доступ к ним всем.
+
+**Сколько это стоит?** $0. Только лимиты бесплатных тарифов провайдеров.
+
+**Какие модели самые быстрые?** Прокси сам измеряет и выбирает. Сейчас
+лидируют Qwen (Groq, ~300ms) и cohere-north (OpenRouter).
+
+**Могу добавить свой провайдер?** Да — впиши его в `config.json` или
+`providers.json`.
+
+**Это только для opencode?** Нет. Любой OpenAI-совместимый клиент
+(см. `examples/` — Cursor, Claude Code, скрипты).
+
+## Инструменты (tools/)
+
+### Генератор шортс — `tools/generate_shorts.py`
+Бесплатная генерация вертикальных видео (9:16) через **MiniMax H3** (видео + звук
+из одного промпта) или **Wan 2.1**. Работает через онлайн-демо Hugging Face —
+GPU в облаке, без установки.
+
+```bash
+cd tools
+uv venv .venv && uv pip install --python .venv/bin/python -r requirements.txt
+export HF_TOKEN=hf_xxx            # бесплатно: huggingface.co → settings/tokens
+./.venv/bin/python generate_shorts.py "Cozy morning scene, warm light" --format 9:16 --duration 5
+```
+
+Каталог готовых промптов: `tools/prompts.md`.
+
+## Лицензия
+
+MIT

package/bin/freegate.js

@@ -0,0 +1,229 @@
+#!/usr/bin/env node
+// bin/davil-cod.js — CLI wrapper + interactive setup wizard
+const path = require('path');
+const fs = require('fs');
+const { spawn } = require('child_process');
+const readline = require('readline');
+
+const ROOT = path.join(__dirname, '..');
+const SERVER = path.join(ROOT, 'server.js');
+const CATALOG = JSON.parse(fs.readFileSync(path.join(ROOT, 'providers.json'), 'utf8'));
+
+// Sequential stdin reader (works with both TTY and piped input)
+function makeReader() {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: false });
+  const queue = [];
+  let buffer = '';
+  rl.on('line', (line) => {
+    const q = queue.shift();
+    if (q) q(line);
+    else buffer += line + '\n';
+  });
+  return function ask(question) {
+    process.stdout.write(question);
+    if (buffer.length) {
+      const idx = buffer.indexOf('\n');
+      const line = idx >= 0 ? buffer.slice(0, idx) : buffer;
+      buffer = idx >= 0 ? buffer.slice(idx + 1) : '';
+      return Promise.resolve(line);
+    }
+    return new Promise((resolve) => queue.push(resolve));
+  };
+}
+
+async function initWizard() {
+  const ask = makeReader();
+
+  // 1. Auth key for the proxy
+  const auth = await ask('Пароль для доступа к прокси (Enter = сгенерировать): ');
+  const authKey = auth.trim() || 'dc_' + Math.random().toString(36).slice(2, 14);
+
+  // 2. Collect provider keys from the catalog (unique env vars)
+  const envVars = new Map(); // envVar -> [providerNames]
+  for (const [name, p] of Object.entries(CATALOG)) {
+    if (!p.envVar) continue;
+    if (!envVars.has(p.envVar)) envVars.set(p.envVar, []);
+    envVars.get(p.envVar).push(name);
+  }
+
+  const keys = {};
+  for (const [envVar, providers] of envVars) {
+    const sample = providers[0];
+    const hint = CATALOG[sample].keyHint || '';
+    const answer = await ask(`\n${providers.join(', ')}\n  Ключ (${hint}) — пусто = пропустить: `);
+    if (answer.trim()) keys[envVar] = answer.trim();
+  }
+
+  // 3. Write .env
+  const envLines = ['# Freegate — API ключи. Сгенерировано ' + new Date().toISOString().slice(0, 10)];
+  for (const envVar of envVars.keys()) {
+    envLines.push(`${envVar}=${keys[envVar] || ''}`);
+  }
+  fs.writeFileSync(path.join(process.cwd(), '.env'), envLines.join('\n') + '\n');
+  console.log('✓ .env создан');
+
+  // 4. Write config.json
+  const config = {
+    port: 4000,
+    auth: authKey,
+    rateLimit: { maxRequests: 100, windowMs: 60000 },
+    providers: {},
+  };
+  fs.writeFileSync(path.join(process.cwd(), 'config.json'), JSON.stringify(config, null, 2));
+  console.log('✓ config.json создан');
+
+  const filled = Object.values(keys).filter(Boolean).length;
+  console.log(`\nГотово! Провайдеров с ключами: ${filled} из ${envVars.size}`);
+  console.log(`Запуск: npx davil-cod start  (пароль: ${authKey})`);
+}
+
+function copyExample(name, example) {
+  const src = path.join(ROOT, example || name + '.example');
+  const dst = path.join(process.cwd(), name);
+  if (fs.existsSync(dst)) { console.log('✓ ' + name + ' уже есть'); return; }
+  if (!fs.existsSync(src)) { console.log('✗ ' + example + ' не найден в пакете'); return; }
+  fs.copyFileSync(src, dst);
+  console.log('✓ создан ' + name + ' — заполни ключи');
+}
+
+const cmd = process.argv[2];
+
+if (cmd === 'init') {
+  if (process.argv.includes('--interactive') || process.argv.includes('-i')) {
+    initWizard().catch((e) => { console.error('Ошибка:', e.message); process.exit(1); });
+  } else {
+    // Non-interactive fallback: plain copy (safe — never overwrites)
+    copyExample('config.json', 'config.example.json');
+    copyExample('.env', '.env.example');
+    console.log('\nГотово! Заполни .env ключами, затем: npx davil-cod start');
+    console.log('Совет: npx davil-cod init -i — интерактивный мастер с вопросами.');
+  }
+} else if (cmd === 'start') {
+  // Spawn from the user's cwd (not package dir) so server.js picks up their
+  // config.json / .env created by `init`.
+  const child = spawn(process.execPath, [SERVER], { stdio: 'inherit' });
+  child.on('close', (c) => process.exit(c || 0));
+} else if (cmd === 'install-service') {
+  const os = require('os');
+  const { execSync } = require('child_process');
+  const isMac = process.platform === 'darwin';
+  const launchDir = process.cwd();
+  const label = 'com.davilcod.proxy';
+
+  if (isMac) {
+    const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>${label}</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>${process.execPath}</string>
+        <string>${SERVER}</string>
+    </array>
+    <key>WorkingDirectory</key>
+    <string>${launchDir}</string>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <true/>
+</dict>
+</plist>`;
+    const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', label + '.plist');
+    fs.writeFileSync(plistPath, plist);
+    execSync(`launchctl unload ${plistPath} 2>/dev/null; launchctl load ${plistPath}`);
+    console.log('✅ Служба автозапуска установлена (launchd)');
+    console.log('   Прокси будет запускаться при включении компьютера');
+  } else {
+    // Linux: systemd user service
+    const unit = `[Unit]
+Description=Freegate LLM proxy
+After=network.target
+
+[Service]
+WorkingDirectory=${launchDir}
+ExecStart=${process.execPath} ${SERVER}
+Restart=always
+RestartSec=5
+
+[Install]
+WantedBy=default.target
+`;
+    const unitPath = path.join(os.homedir(), '.config', 'systemd', 'user', 'davil-cod.service');
+    fs.mkdirSync(path.dirname(unitPath), { recursive: true });
+    fs.writeFileSync(unitPath, unit);
+    execSync(`systemctl --user daemon-reload && systemctl --user enable davil-cod && systemctl --user start davil-cod`);
+    console.log('✅ Служба автозапуска установлена (systemd)');
+  }
+} else if (cmd === 'dashboard') {
+  console.log('Открой http://localhost:4000/ (запусти start сначала)');
+} else if (cmd === 'test') {
+  const http = require('http');
+  const base = `http://127.0.0.1:${process.env.PORT || 4000}`;
+  http.get(base + '/health', (res) => {
+    let data = '';
+    res.on('data', (c) => data += c);
+    res.on('end', () => {
+      if (res.statusCode === 200) {
+        console.log('✅ Прокси работает: ' + data);
+      } else {
+        console.log('❌ Прокси ответил ' + res.statusCode + ': ' + data);
+        process.exit(1);
+      }
+    });
+  }).on('error', (err) => {
+    console.log('❌ Прокси не запущен на ' + base);
+    console.log('   Запусти: npx davil-cod start');
+    process.exit(1);
+  });
+} else if (cmd === 'status') {
+  const http = require('http');
+  const base = `http://127.0.0.1:${process.env.PORT || 4000}`;
+  const pkg = require(path.join(ROOT, 'package.json'));
+  console.log('Freegate v' + pkg.version);
+  console.log('-----------------------------');
+  http.get(base + '/v1/stats', (res) => {
+    let data = '';
+    res.on('data', (c) => data += c);
+    res.on('end', () => {
+      if (res.statusCode !== 200) {
+        console.log('❌ Прокси не отвечает (HTTP ' + res.statusCode + ')');
+        console.log('   Запусти: npx davil-cod start');
+        process.exit(1);
+      }
+      try {
+        const s = JSON.parse(data);
+        console.log(`Запросов: ${s.total_requests} (успех ${s.successful_requests}, ошибок ${s.failed_requests})`);
+        console.log(`Кэш: ${s.cache.size}/${s.cache.maxSize}, точность ${s.cache.hitRate}%`);
+        const up = Object.values(s.health).filter(h => h.status === 'up').length;
+        console.log(`Провайдеры: ${up}/${Object.keys(s.health).length} в строю`);
+        for (const [k, h] of Object.entries(s.health)) {
+          const icon = h.status === 'up' ? '✅' : '❌';
+          const limit = s.limits?.[k];
+          const limitStr = limit ? ` · лимит ${limit.used}/${limit.limit}` : '';
+          console.log(`  ${icon} ${k} (${h.latency_ms}ms)${limitStr}${h.reason ? ' · ' + h.reason : ''}`);
+        }
+      } catch (e) {
+        console.log('❌ Не удалось разобрать ответ: ' + e.message);
+        process.exit(1);
+      }
+    });
+  }).on('error', () => {
+    console.log('❌ Прокси не запущен на ' + base);
+    console.log('   Запусти: npx davil-cod start');
+    process.exit(1);
+  });
+} else if (cmd === 'version' || cmd === '-v' || cmd === '--version') {
+  const pkg = require(path.join(ROOT, 'package.json'));
+  console.log(pkg.version);
+} else {
+  console.log('Freegate — бесплатный LLM-прокси с failover');
+  console.log('Команды:');
+  console.log('  npx davil-cod init       интерактивная настройка (ключи, пароль)');
+  console.log('  npx davil-cod start      запустить прокси');
+  console.log('  npx davil-cod status     диагностика: провайдеры, лимиты, ошибки');
+  console.log('  npx davil-cod test       проверить, что прокси работает');
+  console.log('  npx davil-cod dashboard  открыть дашборд');
+  console.log('  npx davil-cod install-service  автозапуск при старте системы');
+}

package/config.example.json

@@ -0,0 +1,17 @@
+{
+  "$comment": "Copy to config.json. Keys go in .env, not here. Custom providers beyond the catalog go here.",
+  "port": 4000,
+  "auth": "your-secret-key-here",
+  "rateLimit": { "maxRequests": 100, "windowMs": 60000 },
+  "providers": {
+    "or-nemotron-550b": {
+      "endpoint": "https://openrouter.ai/api/v1/chat/completions",
+      "model": "nvidia/nemotron-3-ultra-550b-a55b:free",
+      "priority": 11,
+      "dailyLimit": 50,
+      "keyHint": "openrouter.ai → Keys",
+      "envVar": "PROVIDER_OPENROUTER_APIKEY",
+      "free": true
+    }
+  }
+}