docs: restructure all 30 READMEs — reorder sections, remove duplicates

Changes across README.md + 29 translations:
- Remove 🌐 English | Português (BR) language switcher from top
- Move Free AI Provider agents table below badges/links
- Move 📧 Support section right after agents table
- Move 💡 Key Features before 🎯 Use Cases
- Remove 📊 Available Models section
- Move 🔐 OAuth section inside Troubleshooting
- Remove entire 🇧🇷 Portuguese duplicate section at bottom
This commit is contained in:
diegosouzapw
2026-02-28 09:56:32 -03:00
parent 9a3d72c6a2
commit d9b393a308
31 changed files with 3018 additions and 6733 deletions

View File

@@ -295,67 +295,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 حالات الاستخدام
### الحالة 1: "لدي اشتراك Claude Pro"
**المشكلة:** تنتهي صلاحية الحصة غير المستخدمة، وحدود المعدل أثناء عملية الترميز المكثف
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### الحالة 2: "أريد تكلفة صفرية"
**المشكلة:** لا أستطيع تحمل تكلفة الاشتراكات، وتحتاج إلى ترميز يعتمد على الذكاء الاصطناعي
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### الحالة 3: "أحتاج إلى تشفير على مدار 24 ساعة طوال أيام الأسبوع، دون انقطاع"
**المشكلة:** المواعيد النهائية، لا أستطيع تحمل فترات التوقف عن العمل
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### الحالة 4: "أريد ذكاءً اصطناعيًا مجانيًا في OpenClaw"
**المشكلة:** تحتاج إلى مساعد الذكاء الاصطناعي في تطبيقات المراسلة، مجانًا تمامًا
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 الميزات الرئيسية
### 🧠 التوجيه الأساسي والذكاء
@@ -516,6 +455,67 @@ Combo: "my-coding-stack"
---
## 🎯 حالات الاستخدام
### الحالة 1: "لدي اشتراك Claude Pro"
**المشكلة:** تنتهي صلاحية الحصة غير المستخدمة، وحدود المعدل أثناء عملية الترميز المكثف
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### الحالة 2: "أريد تكلفة صفرية"
**المشكلة:** لا أستطيع تحمل تكلفة الاشتراكات، وتحتاج إلى ترميز يعتمد على الذكاء الاصطناعي
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### الحالة 3: "أحتاج إلى تشفير على مدار 24 ساعة طوال أيام الأسبوع، دون انقطاع"
**المشكلة:** المواعيد النهائية، لا أستطيع تحمل فترات التوقف عن العمل
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### الحالة 4: "أريد ذكاءً اصطناعيًا مجانيًا في OpenClaw"
**المشكلة:** تحتاج إلى مساعد الذكاء الاصطناعي في تطبيقات المراسلة، مجانًا تمامًا
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 دليل الإعداد
<details>
@@ -796,74 +796,6 @@ Settings → API Configuration:
---
## 📊 الموديلات المتوفرة
<details>
<summary><b>عرض جميع الموديلات المتاحة</b></summary>
**كود كلود (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**المخطوطة (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - مجانًا:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**مساعد جيثب (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - أرصدة مجانية:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- أكثر من 50 طرازًا آخر على [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - 0.6 دولار/مليون:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - 0.2 دولار/1 مليون:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - مجانًا:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**كوين (`qw/`)** - مجانًا:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**كيرو (`kr/`)** - مجانًا:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - أكثر من 100 طراز:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- أي موديل من [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 التقييمات (التقييمات)
يشتمل OmniRoute على إطار تقييم مدمج لاختبار جودة استجابة LLM مقابل المجموعة الذهبية. يمكنك الوصول إليه عبر **Analytics → Evals** في لوحة التحكم.
@@ -887,7 +819,58 @@ Settings → API Configuration:
---
## 🔐 OAuth em Servidor Remoto (إعداد OAuth عن بعد)
## 🐛 استكشاف الأخطاء وإصلاحها
<details>
<summary><b>انقر لتوسيع دليل استكشاف الأخطاء وإصلاحها</b></summary>
**"نموذج اللغة لم يقدم رسائل"**
- استنفدت حصة الموفر → تحقق من تعقب حصة الموفر في لوحة المعلومات
- الحل: استخدم خيار التحرير والسرد الاحتياطي أو قم بالتبديل إلى مستوى أرخص
** الحد من المعدل **
- حصة الاشتراك المحددة → الرجوع إلى GLM/MiniMax
- إضافة التحرير والسرد: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
** انتهت صلاحية رمز OAuth **
- يتم التحديث تلقائيًا بواسطة OmniRoute
- إذا استمرت المشكلات: لوحة المعلومات → الموفر → إعادة الاتصال
**تكاليف مرتفعة**
- التحقق من إحصائيات الاستخدام في لوحة المعلومات → التكاليف
- تبديل النموذج الأساسي إلى GLM/MiniMax
- استخدم الطبقة المجانية (Gemini CLI، iFlow) للمهام غير الحرجة
** لوحة المعلومات تفتح على منفذ خاطئ **
- اضبط `PORT=20128` و`NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**أخطاء المزامنة السحابية**
- تحقق من نقاط `BASE_URL` لمثيلك قيد التشغيل
- تحقق من نقاط `CLOUD_URL` إلى نقطة نهاية السحابة المتوقعة
- احتفظ بقيم `NEXT_PUBLIC_*` متوافقة مع القيم من جانب الخادم
**تسجيل الدخول الأول لا يعمل**
- تحقق من `INITIAL_PASSWORD` في `.env`
- في حالة عدم تعيينها، تكون كلمة المرور الاحتياطية هي `123456`
** لا توجد سجلات الطلب **
- اضبط `ENABLE_REQUEST_LOGS=true` في `.env`
**يظهر اختبار الاتصال "غير صالح" لمقدمي الخدمات المتوافقين مع OpenAI**
- لا يكشف العديد من مقدمي الخدمة عن نقطة النهاية `/models`
- يتضمن OmniRoute v1.0.6+ التحقق الاحتياطي من خلال إكمال الدردشة
- تأكد من أن عنوان URL الأساسي يتضمن اللاحقة `/v1`
### 🔐 OAuth em Servidor Remoto (إعداد OAuth عن بعد)
<a name="oauth-em-servidor-remoto"></a>
@@ -978,59 +961,6 @@ Agora o Google redirecionará corretamente para `https://seu-servidor.com/callba
> يعمل هذا الحل البديل لأن رمز التفويض الموجود على عنوان URL يكون صالحًا بشكل مستقل لإعادة التوجيه حيث يتم تحميله أو لا.
---
## 🐛 استكشاف الأخطاء وإصلاحها
<details>
<summary><b>انقر لتوسيع دليل استكشاف الأخطاء وإصلاحها</b></summary>
**"نموذج اللغة لم يقدم رسائل"**
- استنفدت حصة الموفر → تحقق من تعقب حصة الموفر في لوحة المعلومات
- الحل: استخدم خيار التحرير والسرد الاحتياطي أو قم بالتبديل إلى مستوى أرخص
** الحد من المعدل **
- حصة الاشتراك المحددة → الرجوع إلى GLM/MiniMax
- إضافة التحرير والسرد: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
** انتهت صلاحية رمز OAuth **
- يتم التحديث تلقائيًا بواسطة OmniRoute
- إذا استمرت المشكلات: لوحة المعلومات → الموفر → إعادة الاتصال
**تكاليف مرتفعة**
- التحقق من إحصائيات الاستخدام في لوحة المعلومات → التكاليف
- تبديل النموذج الأساسي إلى GLM/MiniMax
- استخدم الطبقة المجانية (Gemini CLI، iFlow) للمهام غير الحرجة
** لوحة المعلومات تفتح على منفذ خاطئ **
- اضبط `PORT=20128` و`NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**أخطاء المزامنة السحابية**
- تحقق من نقاط `BASE_URL` لمثيلك قيد التشغيل
- تحقق من نقاط `CLOUD_URL` إلى نقطة نهاية السحابة المتوقعة
- احتفظ بقيم `NEXT_PUBLIC_*` متوافقة مع القيم من جانب الخادم
**تسجيل الدخول الأول لا يعمل**
- تحقق من `INITIAL_PASSWORD` في `.env`
- في حالة عدم تعيينها، تكون كلمة المرور الاحتياطية هي `123456`
** لا توجد سجلات الطلب **
- اضبط `ENABLE_REQUEST_LOGS=true` في `.env`
**يظهر اختبار الاتصال "غير صالح" لمقدمي الخدمات المتوافقين مع OpenAI**
- لا يكشف العديد من مقدمي الخدمة عن نقطة النهاية `/models`
- يتضمن OmniRoute v1.0.6+ التحقق الاحتياطي من خلال إكمال الدردشة
- تأكد من أن عنوان URL الأساسي يتضمن اللاحقة `/v1`
</details>
---

View File

@@ -3,8 +3,6 @@
# 🚀 OmniRoute — Безплатният AI Gateway
🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
### Никога не спирайте да кодирате. Интелигентно маршрутизиране към **БЕЗПЛАТНИ и евтини AI модели** с автоматичен резервен вариант.
_Вашият универсален API прокси — една крайна точка, 36+ доставчици, нулев престой._
@@ -298,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Случаи на употреба
### Случай 1: „Имам абонамент за Claude Pro“
**Проблем:** Квотата изтича неизползвана, ограничения на скоростта по време на тежко кодиране
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Случай 2: „Искам нулеви разходи“
**Проблем:** Не мога да си позволя абонаменти, имам нужда от надеждно AI кодиране
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Случай 3: „Имам нужда от кодиране 24/7, без прекъсвания“
**Проблем:** Крайни срокове, не мога да си позволя престой
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Случай 4: „Искам БЕЗПЛАТЕН AI в OpenClaw“
**Проблем:** Имате нужда от AI асистент в приложенията за съобщения, напълно безплатно
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Основни характеристики
### 🧠 Основно маршрутизиране и разузнаване
@@ -519,6 +456,67 @@ OmniRoute включва мощна вградена игра за превод
---
## 🎯 Случаи на употреба
### Случай 1: „Имам абонамент за Claude Pro“
**Проблем:** Квотата изтича неизползвана, ограничения на скоростта по време на тежко кодиране
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Случай 2: „Искам нулеви разходи“
**Проблем:** Не мога да си позволя абонаменти, имам нужда от надеждно AI кодиране
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Случай 3: „Имам нужда от кодиране 24/7, без прекъсвания“
**Проблем:** Крайни срокове, не мога да си позволя престой
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Случай 4: „Искам БЕЗПЛАТЕН AI в OpenClaw“
**Проблем:** Имате нужда от AI асистент в приложенията за съобщения, напълно безплатно
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Ръководство за настройка
<details>
@@ -799,74 +797,6 @@ Settings → API Configuration:
---
## 📊 Налични модели
<details>
<summary><b>Вижте всички налични модели</b></summary>
**Claude Code (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Codex (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - БЕЗПЛАТНО:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub Copilot (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - БЕЗПЛАТНИ кредити:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- още 50+ модела на [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - $0,6/1 млн.:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - $0,2/1 млн.:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - БЕЗПЛАТНО:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - БЕЗПЛАТНО:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Киро (`kr/`)** - БЕЗПЛАТНО:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100+ модела:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Всеки модел от [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Оценки (Evals)
OmniRoute включва вградена рамка за оценка за тестване на качеството на отговора на LLM спрямо златен набор. Достъп до него чрез **Analytics → Evals** в таблото за управление.
@@ -890,7 +820,58 @@ OmniRoute включва вградена рамка за оценка за те
---
## 🔐 OAuth em Servidor Remoto (Отдалечена настройка на OAuth)
## 🐛 Отстраняване на неизправности
<details>
<summary><b>Щракнете, за да разширите ръководството за отстраняване на неизправности</b></summary>
**„Езиковият модел не предостави съобщения“**
- Квотата на доставчика е изчерпана → Проверете инструмента за проследяване на квотата на таблото за управление
- Решение: Използвайте комбо резервен вариант или преминете към по-евтино ниво
**Ограничаване на скоростта**
- Изчерпване на квотата за абонамент → Резервно връщане към GLM/MiniMax
- Добавяне на комбинация: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**OAuth токенът е изтекъл**
- Автоматично опресняване от OmniRoute
- Ако проблемите продължават: Табло → Доставчик → Повторно свързване
**Високи разходи**
- Проверете статистическите данни за използването в Табло → Разходи
- Превключете основния модел към GLM/MiniMax
- Използвайте безплатно ниво (Gemini CLI, iFlow) за некритични задачи
**Таблото се отваря на грешен порт**
- Задайте `PORT=20128` и `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Грешки при синхронизиране в облак**
- Потвърдете, че `BASE_URL` сочи към вашия работещ екземпляр
- Проверете `CLOUD_URL` точки към вашата очаквана крайна точка в облака
- Поддържайте стойностите на `NEXT_PUBLIC_*` в съответствие със стойностите от страната на сървъра
**Първото влизане не работи**
- Проверете `INITIAL_PASSWORD` в `.env`
- Ако не е зададена, резервната парола е `123456`
**Няма регистрационни файлове за заявки**
- Задайте `ENABLE_REQUEST_LOGS=true` в `.env`
**Тестът за връзка показва „Невалидно“ за OpenAI-съвместими доставчици**
- Много доставчици не излагат `/models` крайна точка
- OmniRoute v1.0.6+ включва резервно валидиране чрез завършвания на чат
- Уверете се, че основният URL адрес включва суфикс `/v1`
### 🔐 OAuth em Servidor Remoto (Отдалечена настройка на OAuth)
<a name="oauth-em-servidor-remoto"></a>
@@ -981,59 +962,6 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux
> Това заобиколно решение функционира, ако кодът на авторизацията на URL е валиден независимо от пренасочването към пренасочване или не.
---
## 🐛 Отстраняване на неизправности
<details>
<summary><b>Щракнете, за да разширите ръководството за отстраняване на неизправности</b></summary>
**„Езиковият модел не предостави съобщения“**
- Квотата на доставчика е изчерпана → Проверете инструмента за проследяване на квотата на таблото за управление
- Решение: Използвайте комбо резервен вариант или преминете към по-евтино ниво
**Ограничаване на скоростта**
- Изчерпване на квотата за абонамент → Резервно връщане към GLM/MiniMax
- Добавяне на комбинация: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**OAuth токенът е изтекъл**
- Автоматично опресняване от OmniRoute
- Ако проблемите продължават: Табло → Доставчик → Повторно свързване
**Високи разходи**
- Проверете статистическите данни за използването в Табло → Разходи
- Превключете основния модел към GLM/MiniMax
- Използвайте безплатно ниво (Gemini CLI, iFlow) за некритични задачи
**Таблото се отваря на грешен порт**
- Задайте `PORT=20128` и `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Грешки при синхронизиране в облак**
- Потвърдете, че `BASE_URL` сочи към вашия работещ екземпляр
- Проверете `CLOUD_URL` точки към вашата очаквана крайна точка в облака
- Поддържайте стойностите на `NEXT_PUBLIC_*` в съответствие със стойностите от страната на сървъра
**Първото влизане не работи**
- Проверете `INITIAL_PASSWORD` в `.env`
- Ако не е зададена, резервната парола е `123456`
**Няма регистрационни файлове за заявки**
- Задайте `ENABLE_REQUEST_LOGS=true` в `.env`
**Тестът за връзка показва „Невалидно“ за OpenAI-съвместими доставчици**
- Много доставчици не излагат `/models` крайна точка
- OmniRoute v1.0.6+ включва резервно валидиране чрез завършвания на чат
- Уверете се, че основният URL адрес включва суфикс `/v1`
</details>
---
@@ -1176,85 +1104,6 @@ gh release create v1.0.6 --title "v1.0.6" --generate-notes
---
---
## 🇧🇷 OmniRoute — Gateway de IA Gratuito
<a name="-omniroute--gateway-de-ia-gratuito"></a>
### Nunca pare de codar. Roteamento inteligente para **modelos de IA GRATUITOS e de baixo custo** com резервен автоматичен.
_Seu прокси универсален API — um крайна точка, 36+ доставчици, нулев престой._
### 🌐 Internacionalização (i18n)
Таблото за управление на OmniRoute поддържа **múltiplos idiomas**. Актуално налични:
| идиома | Código | Статус |
| ------------------------- | ------- | ------------ |
| 🇺🇸 английски | `en` | ✅ Завършено |
| 🇧🇷 португалски (Бразилия) | `pt-BR` | ✅ Завършено |
**Параметр на трокар или идиома:** Кликнете без избор на идиома (🇺🇸 EN) без заглавка в таблото за управление → избор или избран идиома.
**Para adicionar um new idioma:**
1. Извикайте `src/i18n/messages/{codigo}.json` базирано на `en.json`
2. Добавете кода към `src/i18n/config.ts``LOCALES` и `LANGUAGES`
3. Reinicie или сървър
### ⚡ Início Rápido
```bash
# Instalar via npm
npx omniroute@latest
# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
```
### 🐳 Докер
```bash
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
```
### 🔑 Funcionalidades Principais
- **36+ доставчици на IA** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek и други
- **Roteamento inteligente** — Резервни автоматични агенти
- **Tradução de formato** — OpenAI ↔ Claude ↔ Gemini automaticamente
- **Multi-conta** — Múltiplas contas por provedor com seleção inteligente
- **Cache semântico** — Reduz custos e latência
- **Автоматичен OAuth** — Автоматично обновяване на токени
- **Combos personalizados** — 6 estratégias de roteamento
- **Пълно табло** — Мониторинг, регистрационни файлове, анализи, конфигуриране
- **CLI инструменти** — Конфигуриране на Claude Code, Codex, Cursor, Cline com um clique
- **100% TypeScript** — Лимпо и тип код
### 📖 Documentação
| Документ | Описание |
| ----------------------------------------------- | --------------------------------------- |
| [Guia do Usuário](docs/USER_GUIDE.md) | Доставчици, комбинации, CLI, внедряване |
| [Referência da API](docs/API_REFERENCE.md) | Всички крайни точки с примери |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Общи проблеми и решения |
| [Arquitetura](docs/ARCHITECTURE.md) | Архитектура и вътрешна система |
| [Contribuição](CONTRIBUTING.md) | Setup de desenvolvimento e guidelines |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Пълна версия: VM + nginx + Cloudflare |
### 📧 Подкрепете
> 💬 **Entre para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Двойни гуми, компартилхе дикас и актуализация на фик.
- **Уебсайт**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Проблеми**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
---
<div align="center">
<sub>Създаден с ❤️ за разработчици, които кодират 24/7</sub>
<br/>

View File

@@ -3,8 +3,6 @@
# 🚀 OmniRoute — Den gratis AI-gateway
🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
### Stop aldrig med at kode. Smart routing til **GRATIS og billige AI-modeller** med automatisk fallback.
_Din universelle API-proxy — ét slutpunkt, 36+ udbydere, ingen nedetid._
@@ -298,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Use Cases
### Case 1: "Jeg har Claude Pro-abonnement"
**Problem:** Kvoten udløber ubrugt, satsgrænser under tung kodning
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Case 2: "Jeg vil have nul omkostninger"
**Problem:** Har ikke råd til abonnementer, har brug for pålidelig AI-kodning
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Case 3: "Jeg har brug for 24/7 kodning, ingen afbrydelser"
**Problem:** Deadlines, har ikke råd til nedetid
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Case 4: "Jeg vil have GRATIS AI i OpenClaw"
**Problem:** Har brug for AI-assistent i beskedapps, helt gratis
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Nøglefunktioner
### 🧠 Core Routing & Intelligence
@@ -519,6 +456,67 @@ OmniRoute inkluderer en kraftfuld indbygget oversætterlegeplads med **4 tilstan
---
## 🎯 Use Cases
### Case 1: "Jeg har Claude Pro-abonnement"
**Problem:** Kvoten udløber ubrugt, satsgrænser under tung kodning
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Case 2: "Jeg vil have nul omkostninger"
**Problem:** Har ikke råd til abonnementer, har brug for pålidelig AI-kodning
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Case 3: "Jeg har brug for 24/7 kodning, ingen afbrydelser"
**Problem:** Deadlines, har ikke råd til nedetid
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Case 4: "Jeg vil have GRATIS AI i OpenClaw"
**Problem:** Har brug for AI-assistent i beskedapps, helt gratis
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Opsætningsvejledning
<details>
@@ -799,74 +797,6 @@ Settings → API Configuration:
---
## 📊 Tilgængelige modeller
<details>
<summary><b>Se alle tilgængelige modeller</b></summary>
**Claude-kode (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Codex (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - GRATIS:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub Copilot (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - GRATIS kreditter:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- 50+ flere modeller på [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - 0,6 USD/1 mio.
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - 0,2 USD/1 mio.
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - GRATIS:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - GRATIS:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - GRATIS:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100+ modeller:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Enhver model fra [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Evalueringer (evalueringer)
OmniRoute inkluderer en indbygget evalueringsramme til at teste LLM-svarkvaliteten mod et gyldent sæt. Få adgang til det via **Analytics → Evals** i dashboardet.
@@ -890,7 +820,58 @@ Det forudindlæste "OmniRoute Golden Set" indeholder 10 testcases, der dækker:
---
## 🔐 OAuth em Servidor Remoto (Remote OAuth Setup)
## 🐛 Fejlfinding
<details>
<summary><b>Klik for at udvide fejlfindingsvejledning</b></summary>
**"Sprogmodellen leverede ikke beskeder"**
- Udbyderkvote opbrugt → Tjek dashboardkvotesporing
- Løsning: Brug combo fallback eller skift til et billigere niveau
**Satsbegrænsende**
- Abonnementskontingent ude → Fallback til GLM/MiniMax
- Tilføj kombination: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**OAuth-token er udløbet**
- Automatisk genopfrisket af OmniRoute
- Hvis problemerne fortsætter: Dashboard → Udbyder → Genopret forbindelse
**Høje omkostninger**
- Tjek brugsstatistik i Dashboard → Omkostninger
- Skift primær model til GLM/MiniMax
- Brug gratis niveau (Gemini CLI, iFlow) til ikke-kritiske opgaver
**Dashboard åbner på forkert port**
- Sæt `PORT=20128` og `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Skysynkroniseringsfejl**
- Bekræft `BASE_URL` peger på din løbeforekomst
- Bekræft `CLOUD_URL` point til dit forventede cloud-endepunkt
- Hold `NEXT_PUBLIC_*` værdier på linje med værdier på serversiden
**Første login virker ikke**
- Tjek `INITIAL_PASSWORD` i `.env`
- Hvis den ikke er angivet, er reserveadgangskoden `123456`
**Ingen anmodningslogfiler**
- Indstil `ENABLE_REQUEST_LOGS=true` i `.env`
**Forbindelsestest viser "Ugyldig" for OpenAI-kompatible udbydere**
- Mange udbydere eksponerer ikke et `/models` slutpunkt
- OmniRoute v1.0.6+ inkluderer fallback-validering via chatafslutninger
- Sørg for, at basis-URL'en inkluderer suffikset `/v1`
### 🔐 OAuth em Servidor Remoto (Remote OAuth Setup)
<a name="oauth-em-servidor-remoto"></a>
@@ -981,59 +962,6 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux
> Este workaround funciona porque or código de autorização na URL é válido independente do redirect ter carregado or não.
---
## 🐛 Fejlfinding
<details>
<summary><b>Klik for at udvide fejlfindingsvejledning</b></summary>
**"Sprogmodellen leverede ikke beskeder"**
- Udbyderkvote opbrugt → Tjek dashboardkvotesporing
- Løsning: Brug combo fallback eller skift til et billigere niveau
**Satsbegrænsende**
- Abonnementskontingent ude → Fallback til GLM/MiniMax
- Tilføj kombination: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**OAuth-token er udløbet**
- Automatisk genopfrisket af OmniRoute
- Hvis problemerne fortsætter: Dashboard → Udbyder → Genopret forbindelse
**Høje omkostninger**
- Tjek brugsstatistik i Dashboard → Omkostninger
- Skift primær model til GLM/MiniMax
- Brug gratis niveau (Gemini CLI, iFlow) til ikke-kritiske opgaver
**Dashboard åbner på forkert port**
- Sæt `PORT=20128` og `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Skysynkroniseringsfejl**
- Bekræft `BASE_URL` peger på din løbeforekomst
- Bekræft `CLOUD_URL` point til dit forventede cloud-endepunkt
- Hold `NEXT_PUBLIC_*` værdier på linje med værdier på serversiden
**Første login virker ikke**
- Tjek `INITIAL_PASSWORD` i `.env`
- Hvis den ikke er angivet, er reserveadgangskoden `123456`
**Ingen anmodningslogfiler**
- Indstil `ENABLE_REQUEST_LOGS=true` i `.env`
**Forbindelsestest viser "Ugyldig" for OpenAI-kompatible udbydere**
- Mange udbydere eksponerer ikke et `/models` slutpunkt
- OmniRoute v1.0.6+ inkluderer fallback-validering via chatafslutninger
- Sørg for, at basis-URL'en inkluderer suffikset `/v1`
</details>
---
@@ -1176,85 +1104,6 @@ MIT-licens - se [LICENSE](LICENSE) for detaljer.
---
---
## 🇧🇷 OmniRoute — Gateway de IA Gratis
<a name="-omniroute--gateway-de-ia-gratuito"></a>
### Nunca pare de codar. Roteamento inteligente para **modelos de IA GRATUITOS e de baixo custo** com fallback automático.
_Seu proxy universal de API — et slutpunkt, 36+ tests, nul nedetid._
### 🌐 Internacionalização (i18n)
O dashboard til OmniRoute understøtter **multiplos idiomas**. Atualmente disponível em:
| Idioma | Kode | Status |
| --------------------- | ------- | ---------- |
| 🇺🇸 Engelsk | `en` | ✅ Komplet |
| 🇧🇷 Português (Brasil) | `pt-BR` | ✅ Komplet |
**Para trocar o idioma:** Click no selector de idioma (🇺🇸 EN) no header do dashboard → selection o idioma desejado.
**Sådan tilføjes et nyt formsprog:**
1. Crie `src/i18n/messages/{codigo}.json` baseado em `en.json`
2. Adicione o código em `src/i18n/config.ts``LOCALES` og `LANGUAGES`
3. Reinicie o servidor
### ⚡ Início Rápido
```bash
# Instalar via npm
npx omniroute@latest
# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
```
### 🐳 Docker
```bash
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
```
### 🔑 Funcionalidades Principais
- **36+ provedores de IA** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek, e mais
- **Roteamento inteligente** — Fallback automático entre provedores
- **Tradução de formato** — OpenAI ↔ Claude ↔ Gemini automaticamente
- **Multi-conta** — Múltiplas contas por provedor com seleção inteligente
- **Cache semântico** — Reduz custos e latência
- **OAuth automático** — Tokens renovam automaticamente
- **Combos personalizados** — 6 estratégias de roteamento
- **Dashboard komplet** — Overvågning, logfiler, analyser, konfigurationer
- **CLI Tools** — Konfigurer Claude Code, Codex, Cursor, Cline com um clique
- **100% TypeScript** — Código limpo e tipado
### 📖 Dokumentation
| Dokument | Beskrivelse |
| ----------------------------------------------- | ---------------------------------------------- |
| [Guia do Usuário](docs/USER_GUIDE.md) | Provedores, combos, CLI, implementering |
| [Referência da API](docs/API_REFERENCE.md) | Todos os endepunkter com eksempler |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Problemas comuns e soluções |
| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura e internos do systema |
| [Contribuição](CONTRIBUTING.md) | Opsætning af desenvolvimento og retningslinjer |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Komplet: VM + nginx + Cloudflare |
### 📧 Støtte
> 💬 **Entre para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Træk til, kompartilhe dicas e fique atualizado.
- **Websted**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Problemer**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
---
<div align="center">
<sub>Bygget med ❤️ for udviklere, der koder 24/7</sub>
<br/>

View File

@@ -296,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Anwendungsfälle
### Fall 1: „Ich habe ein Claude Pro Abo"
**Problem:** Kontingent verfällt ungenutzt, Rate-Limits während intensivem Programmieren
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (Abo voll ausnutzen)
2. glm/glm-4.7 (günstiges Backup bei erschöpftem Kontingent)
3. if/kimi-k2-thinking (kostenloser Notfall-Fallback)
Monatliche Kosten: $20 (Abo) + ~$5 (Backup) = $25 gesamt
vs. $20 + an Limits stoßen = Frustration
```
### Fall 2: „Ich will null Kosten"
**Problem:** Kann sich Abos nicht leisten, braucht zuverlässige KI zum Programmieren
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K gratis/Monat)
2. if/kimi-k2-thinking (unbegrenzt gratis)
3. qw/qwen3-coder-plus (unbegrenzt gratis)
Monatliche Kosten: $0
Qualität: Produktionsreife Modelle
```
### Fall 3: „Ich muss 24/7 programmieren, ohne Unterbrechungen"
**Problem:** Enge Deadlines, kann sich keine Ausfallzeit leisten
```
Combo: "always-on"
1. cc/claude-opus-4-6 (beste Qualität)
2. cx/gpt-5.2-codex (zweites Abo)
3. glm/glm-4.7 (günstig, täglicher Reset)
4. minimax/MiniMax-M2.1 (günstigste, 5h Reset)
5. if/kimi-k2-thinking (unbegrenzt kostenlos)
Ergebnis: 5 Fallback-Ebenen = null Ausfallzeit
```
### Fall 4: „Ich will KOSTENLOSE KI in OpenClaw"
**Problem:** Braucht KI-Assistenz in Messaging-Apps, komplett kostenlos
```
Combo: "openclaw-free"
1. if/glm-4.7 (unbegrenzt kostenlos)
2. if/minimax-m2.1 (unbegrenzt kostenlos)
3. if/kimi-k2-thinking (unbegrenzt kostenlos)
Monatliche Kosten: $0
Zugang über: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Hauptfunktionen
### 🧠 Routing & Intelligenz
@@ -498,6 +437,67 @@ Nahtlose Übersetzung zwischen Formaten:
---
## 🎯 Anwendungsfälle
### Fall 1: „Ich habe ein Claude Pro Abo"
**Problem:** Kontingent verfällt ungenutzt, Rate-Limits während intensivem Programmieren
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (Abo voll ausnutzen)
2. glm/glm-4.7 (günstiges Backup bei erschöpftem Kontingent)
3. if/kimi-k2-thinking (kostenloser Notfall-Fallback)
Monatliche Kosten: $20 (Abo) + ~$5 (Backup) = $25 gesamt
vs. $20 + an Limits stoßen = Frustration
```
### Fall 2: „Ich will null Kosten"
**Problem:** Kann sich Abos nicht leisten, braucht zuverlässige KI zum Programmieren
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K gratis/Monat)
2. if/kimi-k2-thinking (unbegrenzt gratis)
3. qw/qwen3-coder-plus (unbegrenzt gratis)
Monatliche Kosten: $0
Qualität: Produktionsreife Modelle
```
### Fall 3: „Ich muss 24/7 programmieren, ohne Unterbrechungen"
**Problem:** Enge Deadlines, kann sich keine Ausfallzeit leisten
```
Combo: "always-on"
1. cc/claude-opus-4-6 (beste Qualität)
2. cx/gpt-5.2-codex (zweites Abo)
3. glm/glm-4.7 (günstig, täglicher Reset)
4. minimax/MiniMax-M2.1 (günstigste, 5h Reset)
5. if/kimi-k2-thinking (unbegrenzt kostenlos)
Ergebnis: 5 Fallback-Ebenen = null Ausfallzeit
```
### Fall 4: „Ich will KOSTENLOSE KI in OpenClaw"
**Problem:** Braucht KI-Assistenz in Messaging-Apps, komplett kostenlos
```
Combo: "openclaw-free"
1. if/glm-4.7 (unbegrenzt kostenlos)
2. if/minimax-m2.1 (unbegrenzt kostenlos)
3. if/kimi-k2-thinking (unbegrenzt kostenlos)
Monatliche Kosten: $0
Zugang über: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Einrichtungsanleitung
<details>
@@ -778,74 +778,6 @@ Einstellungen → API-Konfiguration:
---
## 📊 Verfügbare Modelle
<details>
<summary><b>Alle verfügbaren Modelle anzeigen</b></summary>
**Claude Code (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Codex (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - KOSTENLOS:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub Copilot (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - KOSTENLOSE Credits:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- 50+ weitere Modelle auf [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - $0.6/1M:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - $0.2/1M:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - KOSTENLOS:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - KOSTENLOS:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - KOSTENLOS:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100+ Modelle:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Jedes Modell von [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Evaluierungen (Evals)
OmniRoute enthält ein integriertes Evaluierungs-Framework zum Testen der LLM-Antwortqualität gegen ein Golden Set. Zugang über **Analytics → Evals** im Dashboard.

View File

@@ -300,67 +300,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Casos de Uso
### Caso 1: "Tengo suscripción Claude Pro"
**Problema:** La cuota expira sin usar, límites de tasa durante programación intensa
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (usar suscripción al máximo)
2. glm/glm-4.7 (respaldo barato cuando la cuota se agota)
3. if/kimi-k2-thinking (fallback de emergencia gratuito)
Costo mensual: $20 (suscripción) + ~$5 (respaldo) = $25 total
vs. $20 + chocar con límites = frustración
```
### Caso 2: "Quiero costo cero"
**Problema:** No puede pagar suscripciones, necesita IA confiable para programar
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K gratis/mes)
2. if/kimi-k2-thinking (ilimitado gratis)
3. qw/qwen3-coder-plus (ilimitado gratis)
Costo mensual: $0
Calidad: Modelos listos para producción
```
### Caso 3: "Necesito programar 24/7, sin interrupciones"
**Problema:** Plazos ajustados, no puede permitirse tiempo de inactividad
```
Combo: "always-on"
1. cc/claude-opus-4-6 (mejor calidad)
2. cx/gpt-5.2-codex (segunda suscripción)
3. glm/glm-4.7 (barato, reset diario)
4. minimax/MiniMax-M2.1 (más barato, reset 5h)
5. if/kimi-k2-thinking (gratuito ilimitado)
Resultado: 5 capas de fallback = cero tiempo de inactividad
```
### Caso 4: "Quiero IA GRATUITA en OpenClaw"
**Problema:** Necesita asistente de IA en apps de mensajería, completamente gratuito
```
Combo: "openclaw-free"
1. if/glm-4.7 (ilimitado gratis)
2. if/minimax-m2.1 (ilimitado gratis)
3. if/kimi-k2-thinking (ilimitado gratis)
Costo mensual: $0
Acceso vía: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Características Principales
### 🧠 Enrutamiento e Inteligencia
@@ -502,6 +441,67 @@ Traducción transparente entre formatos:
---
## 🎯 Casos de Uso
### Caso 1: "Tengo suscripción Claude Pro"
**Problema:** La cuota expira sin usar, límites de tasa durante programación intensa
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (usar suscripción al máximo)
2. glm/glm-4.7 (respaldo barato cuando la cuota se agota)
3. if/kimi-k2-thinking (fallback de emergencia gratuito)
Costo mensual: $20 (suscripción) + ~$5 (respaldo) = $25 total
vs. $20 + chocar con límites = frustración
```
### Caso 2: "Quiero costo cero"
**Problema:** No puede pagar suscripciones, necesita IA confiable para programar
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K gratis/mes)
2. if/kimi-k2-thinking (ilimitado gratis)
3. qw/qwen3-coder-plus (ilimitado gratis)
Costo mensual: $0
Calidad: Modelos listos para producción
```
### Caso 3: "Necesito programar 24/7, sin interrupciones"
**Problema:** Plazos ajustados, no puede permitirse tiempo de inactividad
```
Combo: "always-on"
1. cc/claude-opus-4-6 (mejor calidad)
2. cx/gpt-5.2-codex (segunda suscripción)
3. glm/glm-4.7 (barato, reset diario)
4. minimax/MiniMax-M2.1 (más barato, reset 5h)
5. if/kimi-k2-thinking (gratuito ilimitado)
Resultado: 5 capas de fallback = cero tiempo de inactividad
```
### Caso 4: "Quiero IA GRATUITA en OpenClaw"
**Problema:** Necesita asistente de IA en apps de mensajería, completamente gratuito
```
Combo: "openclaw-free"
1. if/glm-4.7 (ilimitado gratis)
2. if/minimax-m2.1 (ilimitado gratis)
3. if/kimi-k2-thinking (ilimitado gratis)
Costo mensual: $0
Acceso vía: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Guía de Configuración
<details>
@@ -782,74 +782,6 @@ Configuración → Configuración de API:
---
## 📊 Modelos Disponibles
<details>
<summary><b>Ver todos los modelos disponibles</b></summary>
**Claude Code (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Codex (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - GRATUITO:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub Copilot (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - Créditos GRATUITOS:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- 50+ más modelos en [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - $0.6/1M:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - $0.2/1M:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - GRATUITO:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - GRATUITO:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - GRATUITO:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100+ modelos:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Cualquier modelo de [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Evaluaciones (Evals)
OmniRoute incluye un framework de evaluación integrado para probar la calidad de respuestas de LLM contra un conjunto golden. Accede vía **Analytics → Evals** en el dashboard.

View File

@@ -3,8 +3,6 @@
# 🚀 OmniRoute — ilmainen tekoälyyhdyskäytävä
🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
### Älä koskaan lopeta koodaamista. Älykäs reititys **ILMAisiin ja edullisiin tekoälymalleihin** automaattisella varalla.
_Universaali API-välityspalvelin yksi päätepiste, yli 36 palveluntarjoajaa, nolla seisokkia._
@@ -298,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Käyttökotelot
### Tapaus 1: "Minulla on Claude Pro -tilaus"
**Ongelma:** Kiintiö vanhenee käyttämättä, nopeusrajoitukset raskaan koodauksen aikana
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Tapaus 2: "Haluan ilman kustannuksia"
**Ongelma:** Ei ole varaa tilauksiin, tarvitaan luotettavaa tekoälykoodausta
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Tapaus 3: "Tarvitsen 24/7-koodausta, ei keskeytyksiä"
**Ongelma:** Määräajat, seisokkeihin ei ole varaa
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Tapaus 4: "Haluan ILMAISTA tekoälyä OpenClawissa"
**Ongelma:** Tarvitset AI-avustajan viestisovelluksissa, täysin ilmainen
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Tärkeimmät ominaisuudet
### 🧠 Ydinreititys ja älykkyys
@@ -519,6 +456,67 @@ OmniRoute sisältää tehokkaan sisäänrakennetun Translator Playgroundin, joss
---
## 🎯 Käyttökotelot
### Tapaus 1: "Minulla on Claude Pro -tilaus"
**Ongelma:** Kiintiö vanhenee käyttämättä, nopeusrajoitukset raskaan koodauksen aikana
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Tapaus 2: "Haluan ilman kustannuksia"
**Ongelma:** Ei ole varaa tilauksiin, tarvitaan luotettavaa tekoälykoodausta
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Tapaus 3: "Tarvitsen 24/7-koodausta, ei keskeytyksiä"
**Ongelma:** Määräajat, seisokkeihin ei ole varaa
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Tapaus 4: "Haluan ILMAISTA tekoälyä OpenClawissa"
**Ongelma:** Tarvitset AI-avustajan viestisovelluksissa, täysin ilmainen
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Asennusopas
<details>
@@ -799,74 +797,6 @@ Settings → API Configuration:
---
## 📊 Saatavilla olevat mallit
<details>
<summary><b>Näytä kaikki saatavilla olevat mallit</b></summary>
**Claude Code (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Koodi (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - ILMAINEN:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub Copilot (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - ILMAISIA krediittejä:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- Yli 50 mallia [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - 0,6 $/1 milj.:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - 0,2 $/1 milj.
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - ILMAINEN:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - ILMAINEN:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - ILMAINEN:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100+ mallia:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Mikä tahansa malli alkaen [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Arvioinnit (Evals)
OmniRoute sisältää sisäänrakennetun arviointikehyksen, jolla testataan LLM-vastauksen laatua kultaiseen joukkoon verrattuna. Käytä sitä kojelaudan **Analytics → Evals** kautta.
@@ -890,7 +820,58 @@ Esiladattu "OmniRoute Golden Set" sisältää 10 testitapausta, jotka kattavat:
---
## 🔐 OAuth em Servidor Remoto (OAuth-etäasetus)
## 🐛 Vianetsintä
<details>
<summary><b>Laajenna vianetsintäopas napsauttamalla</b></summary>
**"Kielimalli ei antanut viestejä"**
- Palveluntarjoajan kiintiö käytetty loppuun → Tarkista kojelaudan kiintiön seuranta
- Ratkaisu: Käytä yhdistelmävaraa tai vaihda halvempaan tasoon
**hintarajoitus**
- Tilauskiintiö loppu → Varaa GLM/MiniMaxiin
- Lisää yhdistelmä: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**OAuth-tunnus vanhentunut**
- OmniRoute päivittää automaattisesti
- Jos ongelmat jatkuvat: Kojelauta → Palveluntarjoaja → Yhdistä uudelleen
**Korkeat kustannukset**
- Tarkista käyttötilastot kohdassa Dashboard → Costs
- Vaihda ensisijaiseksi malliksi GLM/MiniMax
- Käytä ilmaista tasoa (Gemini CLI, iFlow) ei-kriittisiin tehtäviin
**Kojelauta avautuu väärään porttiin**
- Aseta `PORT=20128` ja `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Pilvisynkronointivirheet**
- Vahvista `BASE_URL` pistettä käynnissä olevaan esiintymääsi
- Vahvista `CLOUD_URL` pistettä odotettuun pilvipäätepisteeseen
- Pidä `NEXT_PUBLIC_*`-arvot kohdakkain palvelinpuolen arvojen kanssa
**Ensimmäinen kirjautuminen ei toimi**
- Tarkista `INITIAL_PASSWORD` kohteessa `.env`
- Jos ei ole asetettu, varasalasana on `123456`
**Ei pyyntölokeja**
- Aseta `ENABLE_REQUEST_LOGS=true` kohteeseen `.env`
**Yhteystesti näyttää "Virheellinen" OpenAI-yhteensopiville palveluntarjoajille**
- Monet palveluntarjoajat eivät paljasta `/models`-päätepistettä
- OmniRoute v1.0.6+ sisältää varatarkistuksen chatin loppuunsaattamisen kautta
- Varmista, että perus-URL sisältää `/v1`-liitteen
### 🔐 OAuth em Servidor Remoto (OAuth-etäasetus)
<a name="oauth-em-servidor-remoto"></a>
@@ -969,7 +950,7 @@ Agora o Google redirecionará corretamente para `https://seu-servidor.com/callba
---
### Workaround temporário (sem configurar credenciais próprias)
#### Workaround temporário (sem configurar credenciais próprias)
Se não quiser criar credenciais próprias agora, ainda é possível usar o fluxo **manual de URL**:
@@ -981,59 +962,6 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux
> Este workaround funciona porque o código de autorização na URL é válido independente do redirect ter carregado ou não.
---
## 🐛 Vianetsintä
<details>
<summary><b>Laajenna vianetsintäopas napsauttamalla</b></summary>
**"Kielimalli ei antanut viestejä"**
- Palveluntarjoajan kiintiö käytetty loppuun → Tarkista kojelaudan kiintiön seuranta
- Ratkaisu: Käytä yhdistelmävaraa tai vaihda halvempaan tasoon
**hintarajoitus**
- Tilauskiintiö loppu → Varaa GLM/MiniMaxiin
- Lisää yhdistelmä: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**OAuth-tunnus vanhentunut**
- OmniRoute päivittää automaattisesti
- Jos ongelmat jatkuvat: Kojelauta → Palveluntarjoaja → Yhdistä uudelleen
**Korkeat kustannukset**
- Tarkista käyttötilastot kohdassa Dashboard → Costs
- Vaihda ensisijaiseksi malliksi GLM/MiniMax
- Käytä ilmaista tasoa (Gemini CLI, iFlow) ei-kriittisiin tehtäviin
**Kojelauta avautuu väärään porttiin**
- Aseta `PORT=20128` ja `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Pilvisynkronointivirheet**
- Vahvista `BASE_URL` pistettä käynnissä olevaan esiintymääsi
- Vahvista `CLOUD_URL` pistettä odotettuun pilvipäätepisteeseen
- Pidä `NEXT_PUBLIC_*`-arvot kohdakkain palvelinpuolen arvojen kanssa
**Ensimmäinen kirjautuminen ei toimi**
- Tarkista `INITIAL_PASSWORD` kohteessa `.env`
- Jos ei ole asetettu, varasalasana on `123456`
**Ei pyyntölokeja**
- Aseta `ENABLE_REQUEST_LOGS=true` kohteeseen `.env`
**Yhteystesti näyttää "Virheellinen" OpenAI-yhteensopiville palveluntarjoajille**
- Monet palveluntarjoajat eivät paljasta `/models`-päätepistettä
- OmniRoute v1.0.6+ sisältää varatarkistuksen chatin loppuunsaattamisen kautta
- Varmista, että perus-URL sisältää `/v1`-liitteen
</details>
---
@@ -1176,85 +1104,6 @@ MIT-lisenssi katso lisätietoja osoitteesta [LICENSE](LICENSE).
---
---
## 🇧🇷 OmniRoute — Gateway de IA Gratuito
<a name="-omniroute--gateway-de-ia-gratuito"></a>
### Nunca pare de codar. Roteamento inteligente para **mallit de IA GRATUITOS e de baixo custo** com backback automático.
_Seu välityspalvelin universaali de API — um päätepiste, 36+ valmistajaa, nolla seisokkeja._
### 🌐 Internacionalização (i18n)
OmniRoute-kojelauta tukee **múltiplos idiomas**. Atualmente disponível em:
| Idioma | Código | Tila |
| ----------------------- | ------- | -------------- |
| 🇺🇸 englanti | `en` | ✅ Täydellinen |
| 🇧🇷 Português (Brasilia) | `pt-BR` | ✅ Täydellinen |
**Para trocar o idioma:** Clique no seletor de idioma (🇺🇸 FI) no header do dashboard → selecione o idioma desejado.
**Para adicionar um novo idioma:**
1. Itke `src/i18n/messages/{codigo}.json` baseado em `en.json`
2. Adicione o código em `src/i18n/config.ts``LOCALES` ja `LANGUAGES`
3. Reinicie o servidor
### ⚡ Início Rápido
```bash
# Instalar via npm
npx omniroute@latest
# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
```
### 🐳 Docker
```bash
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
```
### 🔑 Funcionalidades Principais
- **36+ IA:n tuottajaa** Claude, GPT, Gemini, Llama, Qwen, DeepSeek, e mais
- **Roteamento inteligente** — Varastoautomatico entre provedores
- **Tradução de formato** — OpenAI ↔ Claude ↔ Gemini automaticamente
- **Multi-conta** — Múltiplas contas por provedor com seleção inteligente
- **Cache semântico** - Reduz custos e latência
- **OAuth automático** — Tokens renovam automaticamente
- **Yhdistelmät personoidut** - 6 estratégias de roteamento
- **Dashboard Completo** - Monitoramento, lokit, analyysit, konfiguraatiot
- **CLI-työkalut** — Määritä Claude Code, Codex, Cursor, Cline com um clique
- **100 % TypeScript** - Código limpo e tipado
### 📖 Documentação
| Documento | Kuvaus |
| ----------------------------------------------- | ------------------------------------------- |
| [Guia do Usuário](docs/USER_GUIDE.md) | Provedorit, yhdistelmät, CLI, käyttöönotto |
| [Referência da API](docs/API_REFERENCE.md) | Todos os päätepisteet com exemplos |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Problemas comuns e soluções |
| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura e internos do system |
| [Contribuição](CONTRIBUTING.md) | Desenvolvimento e -ohjeiden asennus |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Täydellinen versio: VM + nginx + Cloudflare |
### 📧 Tuki
> 💬 **Entre para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tire dúvidas, compartilhe dicas e fique atualizado.
- **Verkkosivusto**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Ongelmia**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
---
<div align="center">
<sub>Rakennettu ❤️-kehittäjille, jotka koodaavat 24/7</sub>
<br/>

View File

@@ -298,67 +298,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Cas d'utilisation
### Cas 1 : « J'ai un abonnement Claude Pro »
**Problème :** Le quota expire inutilisé, limites de débit pendant le codage intensif
```
Combo : "maximize-claude"
1. cc/claude-opus-4-6 (utiliser l'abonnement au maximum)
2. glm/glm-4.7 (backup économique quand le quota est épuisé)
3. if/kimi-k2-thinking (fallback d'urgence gratuit)
Coût mensuel : 20 $ (abonnement) + ~5 $ (backup) = 25 $ au total
vs. 20 $ + atteindre les limites = frustration
```
### Cas 2 : « Je veux zéro coût »
**Problème :** Impossible de payer des abonnements, besoin d'IA fiable pour coder
```
Combo : "free-forever"
1. gc/gemini-3-flash (180K gratuits/mois)
2. if/kimi-k2-thinking (illimité gratuit)
3. qw/qwen3-coder-plus (illimité gratuit)
Coût mensuel : 0 $
Qualité : Modèles prêts pour la production
```
### Cas 3 : « Je dois coder 24/7, sans interruption »
**Problème :** Délais serrés, ne peut pas se permettre de temps d'arrêt
```
Combo : "always-on"
1. cc/claude-opus-4-6 (meilleure qualité)
2. cx/gpt-5.2-codex (deuxième abonnement)
3. glm/glm-4.7 (économique, reset quotidien)
4. minimax/MiniMax-M2.1 (le moins cher, reset 5h)
5. if/kimi-k2-thinking (gratuit illimité)
Résultat : 5 niveaux de fallback = zéro temps d'arrêt
```
### Cas 4 : « Je veux l'IA GRATUITE dans OpenClaw »
**Problème :** Besoin d'assistant IA dans les apps de messagerie, entièrement gratuit
```
Combo : "openclaw-free"
1. if/glm-4.7 (illimité gratuit)
2. if/minimax-m2.1 (illimité gratuit)
3. if/kimi-k2-thinking (illimité gratuit)
Coût mensuel : 0 $
Accès via : WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Fonctionnalités principales
### 🧠 Routage & Intelligence
@@ -500,6 +439,67 @@ Traduction transparente entre les formats :
---
## 🎯 Cas d'utilisation
### Cas 1 : « J'ai un abonnement Claude Pro »
**Problème :** Le quota expire inutilisé, limites de débit pendant le codage intensif
```
Combo : "maximize-claude"
1. cc/claude-opus-4-6 (utiliser l'abonnement au maximum)
2. glm/glm-4.7 (backup économique quand le quota est épuisé)
3. if/kimi-k2-thinking (fallback d'urgence gratuit)
Coût mensuel : 20 $ (abonnement) + ~5 $ (backup) = 25 $ au total
vs. 20 $ + atteindre les limites = frustration
```
### Cas 2 : « Je veux zéro coût »
**Problème :** Impossible de payer des abonnements, besoin d'IA fiable pour coder
```
Combo : "free-forever"
1. gc/gemini-3-flash (180K gratuits/mois)
2. if/kimi-k2-thinking (illimité gratuit)
3. qw/qwen3-coder-plus (illimité gratuit)
Coût mensuel : 0 $
Qualité : Modèles prêts pour la production
```
### Cas 3 : « Je dois coder 24/7, sans interruption »
**Problème :** Délais serrés, ne peut pas se permettre de temps d'arrêt
```
Combo : "always-on"
1. cc/claude-opus-4-6 (meilleure qualité)
2. cx/gpt-5.2-codex (deuxième abonnement)
3. glm/glm-4.7 (économique, reset quotidien)
4. minimax/MiniMax-M2.1 (le moins cher, reset 5h)
5. if/kimi-k2-thinking (gratuit illimité)
Résultat : 5 niveaux de fallback = zéro temps d'arrêt
```
### Cas 4 : « Je veux l'IA GRATUITE dans OpenClaw »
**Problème :** Besoin d'assistant IA dans les apps de messagerie, entièrement gratuit
```
Combo : "openclaw-free"
1. if/glm-4.7 (illimité gratuit)
2. if/minimax-m2.1 (illimité gratuit)
3. if/kimi-k2-thinking (illimité gratuit)
Coût mensuel : 0 $
Accès via : WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Guide de configuration
<details>
@@ -780,74 +780,6 @@ Paramètres → Configuration API :
---
## 📊 Modèles disponibles
<details>
<summary><b>Voir tous les modèles disponibles</b></summary>
**Claude Code (`cc/`)** - Pro/Max :
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Codex (`cx/`)** - Plus/Pro :
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - GRATUIT :
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub Copilot (`gh/`)** :
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - Crédits GRATUITS :
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- 50+ modèles sur [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - $0.6/1M :
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - $0.2/1M :
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - GRATUIT :
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - GRATUIT :
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - GRATUIT :
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100+ modèles :
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Tout modèle de [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Évaluations (Evals)
OmniRoute inclut un framework d'évaluation intégré pour tester la qualité des réponses LLM contre un golden set. Accès via **Analytics → Evals** dans le tableau de bord.

View File

@@ -3,8 +3,6 @@
# 🚀 OmniRoute — שער הבינה המלאכותית החינמית
🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
### לעולם אל תפסיק לקוד. ניתוב חכם לדגמי בינה מלאכותית **בחינם ובעלות נמוכה** עם חזרה אוטומטית.
_שרת ה-API האוניברסלי שלך - נקודת קצה אחת, 36+ ספקים, אפס זמן השבתה._
@@ -298,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 מקרי שימוש
### מקרה 1: "יש לי מנוי לקלוד פרו"
**בעיה:** תוקף המכסה פג ללא שימוש, מגבלות תעריף במהלך קידוד כבד
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### מקרה 2: "אני רוצה עלות אפס"
**בעיה:** לא יכול להרשות לעצמו מנויים, צריך קידוד AI אמין
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### מקרה 3: "אני צריך קידוד 24/7, ללא הפרעות"
**בעיה:** מועדים, לא יכול להרשות לעצמו זמן השבתה
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### מקרה 4: "אני רוצה AI בחינם ב-OpenClaw"
**בעיה:** צריך עוזר בינה מלאכותית באפליקציות הודעות, בחינם לחלוטין
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 תכונות עיקריות
### 🧠 ניתוב ליבה ומודיעין
@@ -519,6 +456,67 @@ OmniRoute כולל מגרש משחקי מתרגמים מובנה רב עוצמה
---
## 🎯 מקרי שימוש
### מקרה 1: "יש לי מנוי לקלוד פרו"
**בעיה:** תוקף המכסה פג ללא שימוש, מגבלות תעריף במהלך קידוד כבד
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### מקרה 2: "אני רוצה עלות אפס"
**בעיה:** לא יכול להרשות לעצמו מנויים, צריך קידוד AI אמין
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### מקרה 3: "אני צריך קידוד 24/7, ללא הפרעות"
**בעיה:** מועדים, לא יכול להרשות לעצמו זמן השבתה
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### מקרה 4: "אני רוצה AI בחינם ב-OpenClaw"
**בעיה:** צריך עוזר בינה מלאכותית באפליקציות הודעות, בחינם לחלוטין
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 מדריך התקנה
<details>
@@ -799,74 +797,6 @@ Settings → API Configuration:
---
## 📊 דגמים זמינים
<details>
<summary><b>הצג את כל הדגמים הזמינים</b></summary>
**קוד קלוד (`cc/`)** - פרו/מקסימום:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**קודקס (`cx/`)** - פלוס/יתרונות:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - בחינם:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub Copilot (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - זיכויים בחינם:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- 50+ דגמים נוספים ב-[build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - $0.6/1 מיליון:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - $0.2/1 מיליון:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - בחינם:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - בחינם:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - בחינם:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100+ דגמים:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- כל דגם מ-[openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 הערכות (הערכות)
OmniRoute כולל מסגרת הערכה מובנית לבדיקת איכות תגובת LLM מול סט מוזהב. גש אליו דרך **Analytics → Evals** בלוח המחוונים.
@@ -890,7 +820,58 @@ OmniRoute כולל מסגרת הערכה מובנית לבדיקת איכות ת
---
## 🔐 OAuth em Servidor Remoto (הגדרת OAuth מרחוק)
## 🐛 פתרון בעיות
<details>
<summary><b>לחץ כדי להרחיב את המדריך לפתרון בעיות</b></summary>
**"מודל השפה לא סיפק הודעות"**
- מיצתה מכסת הספק ← בדוק את עוקב המכסות של לוח המחוונים
- פתרון: השתמש ב-combo fallback או עבור לשכבה זולה יותר
**הגבלת תעריפים**
- מכסת מנויים נגמרת ← Fallback ל-GLM/MiniMax
- הוסף שילוב: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**פג תוקפו של אסימון OAuth**
- רענון אוטומטי על ידי OmniRoute
- אם הבעיות נמשכות: לוח מחוונים ← ספק ← התחבר מחדש
**עלויות גבוהות**
- בדוק סטטיסטיקת שימוש בלוח המחוונים ← עלויות
- החלף את הדגם הראשי ל-GLM/MiniMax
- השתמש בשכבה חינמית (Gemini CLI, iFlow) עבור משימות לא קריטיות
**לוח המחוונים נפתח ביציאה שגויה**
- הגדר `PORT=20128` ו`NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**שגיאות סנכרון בענן**
- אמת `BASE_URL` נקודות למופע הריצה שלך
- אמת `CLOUD_URL` נקודות לנקודת הקצה הצפויה שלך בענן
- שמור על ערכי `NEXT_PUBLIC_*` מיושרים עם ערכי צד השרת
**הכניסה הראשונה לא עובדת**
- בדוק את `INITIAL_PASSWORD` ב-`.env`
- אם לא מוגדרת, סיסמת החלפה היא `123456`
**ללא יומני בקשות**
- הגדר `ENABLE_REQUEST_LOGS=true` ב-`.env`
**בדיקת חיבור מראה "לא חוקי" עבור ספקים תואמי OpenAI**
- ספקים רבים אינם חושפים נקודת קצה `/models`
- OmniRoute v1.0.6+ כולל אימות חוזר באמצעות השלמת צ'אט
- ודא שכתובת האתר הבסיסית כוללת את הסיומת `/v1`
### 🔐 OAuth em Servidor Remoto (הגדרת OAuth מרחוק)
<a name="oauth-em-servidor-remoto"></a>
@@ -981,59 +962,6 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux
> פתרון עקיפת הבעיה או קוד אוטומטי של כתובת ה-URL או עצמאית להפנות את החשבון או לא.
---
## 🐛 פתרון בעיות
<details>
<summary><b>לחץ כדי להרחיב את המדריך לפתרון בעיות</b></summary>
**"מודל השפה לא סיפק הודעות"**
- מיצתה מכסת הספק ← בדוק את עוקב המכסות של לוח המחוונים
- פתרון: השתמש ב-combo fallback או עבור לשכבה זולה יותר
**הגבלת תעריפים**
- מכסת מנויים נגמרת ← Fallback ל-GLM/MiniMax
- הוסף שילוב: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**פג תוקפו של אסימון OAuth**
- רענון אוטומטי על ידי OmniRoute
- אם הבעיות נמשכות: לוח מחוונים ← ספק ← התחבר מחדש
**עלויות גבוהות**
- בדוק סטטיסטיקת שימוש בלוח המחוונים ← עלויות
- החלף את הדגם הראשי ל-GLM/MiniMax
- השתמש בשכבה חינמית (Gemini CLI, iFlow) עבור משימות לא קריטיות
**לוח המחוונים נפתח ביציאה שגויה**
- הגדר `PORT=20128` ו`NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**שגיאות סנכרון בענן**
- אמת `BASE_URL` נקודות למופע הריצה שלך
- אמת `CLOUD_URL` נקודות לנקודת הקצה הצפויה שלך בענן
- שמור על ערכי `NEXT_PUBLIC_*` מיושרים עם ערכי צד השרת
**הכניסה הראשונה לא עובדת**
- בדוק את `INITIAL_PASSWORD` ב-`.env`
- אם לא מוגדרת, סיסמת החלפה היא `123456`
**ללא יומני בקשות**
- הגדר `ENABLE_REQUEST_LOGS=true` ב-`.env`
**בדיקת חיבור מראה "לא חוקי" עבור ספקים תואמי OpenAI**
- ספקים רבים אינם חושפים נקודת קצה `/models`
- OmniRoute v1.0.6+ כולל אימות חוזר באמצעות השלמת צ'אט
- ודא שכתובת האתר הבסיסית כוללת את הסיומת `/v1`
</details>
---
@@ -1176,85 +1104,6 @@ gh release create v1.0.6 --title "v1.0.6" --generate-notes
---
---
## 🇧🇷 OmniRoute — Gateway de IA Gratuito
<a name="-omniroute--gateway-de-ia-gratuito"></a>
### Nunca pare de codar. Roteamento intelligente עבור **מודלים של IA GRATUITOS e de baixo custo** com fallback automático.
_Seu proxy universal de API - נקודת קצה, 36+ בדיקות, אפס השבתה._
### 🌐 Internacionalização (i18n)
O לוח המחוונים של OmniRoute תומך ב-**רב ביטויים**. ניתנת הספק:
| אידיומה | קודיגו | סטטוס |
| -------------------- | ------- | ---------- |
| 🇺🇸 אנגלית | `en` | ✅ קומפלטו |
| 🇧🇷 פורטוגזית (ברזיל) | `pt-BR` | ✅ קומפלטו |
**למקרה של ביטוי:** לחץ על לא בחירה בשפה (🇺🇸 EN) ללא כותרת ללוח המחוונים ← בחירה בצורת ביטוי.
**לפרטים נוספים:**
1. Crie `src/i18n/messages/{codigo}.json` baseado em `en.json`
2. Adicone o código em `src/i18n/config.ts``LOCALES` e `LANGUAGES`
3. Reinicie o servidor
### ⚡ Início Rápido
```bash
# Instalar via npm
npx omniroute@latest
# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
```
### 🐳 דוקר
```bash
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
```
### 🔑 Funcionalidades Principais
- **36+ provedores de IA** - קלוד, GPT, Gemini, Llama, Qwen, DeepSeek, e mais
- **Roteamento inteligente** - Fallback automático entre provedores
- **Tradução de formato** — OpenAI ↔ קלוד ↔ Gemini automaticamente
- **מולטי-קונטא** - Múltiplas contas por provedor com seleção intelligente
- **Cache semântico** — Reduz custos e latência
- **OAuth automático** — אסימונים renovam automaticamente
- **Combos personalizados** - 6 estratégias de roteamento
- **לוח המחוונים המלא** - מעקב, יומנים, ניתוחים, הגדרות
- **כלי CLI** - הגדר את קוד קלוד, Codex, Cursor, Cline com um clique
- **100% TypeScript** — קוד רגיל
### 📖 תיעוד
| דוקומנטו | תיאור |
| ----------------------------------------------- | ---------------------------------- |
| [Guia do Usuário](docs/USER_GUIDE.md) | פרובדורים, שילובים, CLI, פריסה |
| [Referência da API](docs/API_REFERENCE.md) | Todos OS נקודות קצה com exemplos |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Problemas comuns e soluções |
| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura e internos do sistema |
| [Contribuição](CONTRIBUTING.md) | התקנה של הנחיות והנחיות |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | גיאה מלאה: VM + nginx + Cloudflare |
### 📧 תמיכה
> 💬 **Entre para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tire dúvidas, compartilhe dicas e fique atualizado.
- **אתר**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **בעיות**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
---
<div align="center">
<sub>נבנה עם ❤️ למפתחים שמקודדים 24/7</sub>
<br/>

View File

@@ -3,8 +3,6 @@
# 🚀 OmniRoute Az ingyenes mesterséges intelligencia átjáró
🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
### Soha ne hagyd abba a kódolást. Intelligens útválasztás **INGYENES és alacsony költségű mesterséges intelligencia modellekhez** automatikus visszaállítással.
_Az univerzális API-proxy egy végpont, 36+ szolgáltató, nulla állásidő._
@@ -298,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Használati esetek
### 1. eset: "Claude Pro előfizetésem van"
**Probléma:** A kvóta lejár, kihasználatlanul, sebességkorlátozások erős kódolás közben
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### 2. eset: "Nulla költséget akarok"
**Probléma:** Nem engedheti meg magának az előfizetést, megbízható mesterséges intelligencia kódolásra van szüksége
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### 3. eset: "24 órás kódolásra van szükségem, megszakítás nélkül"
**Probléma:** Határidők, nem engedheti meg magának az állásidőt
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### 4. eset: "INGYENES AI-t akarok az OpenClawban"
**Probléma:** AI-asszisztens szükséges az üzenetküldő alkalmazásokhoz, teljesen ingyenes
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Főbb jellemzők
### 🧠 Core Routing & Intelligence
@@ -519,6 +456,67 @@ Az OmniRoute egy erőteljes beépített fordítói játszóteret tartalmaz **4 m
---
## 🎯 Használati esetek
### 1. eset: "Claude Pro előfizetésem van"
**Probléma:** A kvóta lejár, kihasználatlanul, sebességkorlátozások erős kódolás közben
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### 2. eset: "Nulla költséget akarok"
**Probléma:** Nem engedheti meg magának az előfizetést, megbízható mesterséges intelligencia kódolásra van szüksége
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### 3. eset: "24 órás kódolásra van szükségem, megszakítás nélkül"
**Probléma:** Határidők, nem engedheti meg magának az állásidőt
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### 4. eset: "INGYENES AI-t akarok az OpenClawban"
**Probléma:** AI-asszisztens szükséges az üzenetküldő alkalmazásokhoz, teljesen ingyenes
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Beállítási útmutató
<details>
@@ -799,74 +797,6 @@ Settings → API Configuration:
---
## 📊 Elérhető modellek
<details>
<summary><b>Az összes elérhető modell megtekintése</b></summary>
**Claude Code (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Kód (`cx/`)** - Plusz/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** INGYENES:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub másodpilóta (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - INGYENES kreditek:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- 50+ további modell itt: [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - 0,6 USD/1 millió:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - 0,2 USD/1 millió:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** INGYENES:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - INGYENES:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** INGYENES:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100+ modell:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Bármelyik modell a [openrouter.ai/models](https://openrouter.ai/models) terméktől
</details>
---
## 🧪 Értékelések (Evals)
Az OmniRoute egy beépített értékelési keretrendszert tartalmaz az LLM-válasz minőségének tesztelésére egy aranykészlettel összehasonlítva. Az irányítópult **Analytics → Evals** menüpontjában érheti el.
@@ -890,7 +820,58 @@ Az előre feltöltött "OmniRoute Golden Set" 10 tesztesetet tartalmaz, amelyek
---
## 🔐 OAuth em Servidor Remoto (távoli OAuth beállítás)
## 🐛 Hibaelhárítás
<details>
<summary><b>Kattintson a hibaelhárítási útmutató kibontásához</b></summary>
**"A nyelvi modell nem adott üzenetet"**
- A szolgáltatói kvóta kimerült → Ellenőrizze az irányítópult kvótakövetőjét
- Megoldás: Használjon kombinált tartalékot, vagy váltson olcsóbb szintre
**Drátakorlát**
- Előfizetési kvóta lejárt → Tartalék a GLM/MiniMax-hoz
- Kombinó hozzáadása: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**OAuth token lejárt**
- Az OmniRoute automatikusan frissíti
- Ha a problémák továbbra is fennállnak: Irányítópult → Szolgáltató → Újracsatlakozás
**Magas költségek**
- Ellenőrizze a használati statisztikákat az Irányítópult → Költségek menüpontban
- Állítsa át az elsődleges modellt GLM/MiniMax-ra
- Használjon ingyenes réteget (Gemini CLI, iFlow) a nem kritikus feladatokhoz
**A műszerfal rossz porton nyílik meg**
- `PORT=20128` és `NEXT_PUBLIC_BASE_URL=http://localhost:20128` beállítása
**Felhő szinkronizálási hibák**
- Ellenőrizze, hogy `BASE_URL` mutat a futó példányra
- Ellenőrizzen `CLOUD_URL` pontot a várható felhő-végponthoz
- Tartsa az `NEXT_PUBLIC_*` értékeket a szerveroldali értékekkel összhangban
**Az első bejelentkezés nem működik**
- Ellenőrizze a `INITIAL_PASSWORD`-t itt: `.env`
- Ha nincs beállítva, a tartalék jelszó: `123456`
**Nincs kérésnapló**
- Állítsa be `ENABLE_REQUEST_LOGS=true` a `.env`-ban
**A csatlakozási teszt „Érvénytelen” üzenetet mutat az OpenAI-kompatibilis szolgáltatók esetében**
- Sok szolgáltató nem tesz közzé `/models` végpontot
- Az OmniRoute v1.0.6+ tartalmazza a tartalék érvényesítést a csevegés befejezésén keresztül
- Győződjön meg arról, hogy az alap URL tartalmazza a `/v1` utótagot
### 🔐 OAuth em Servidor Remoto (távoli OAuth beállítás)
<a name="oauth-em-servidor-remoto"></a>
@@ -981,59 +962,6 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux
> Este workaround funciona porque o código de autorização na URL é válido independente do redirect ter carregado ou não.
---
## 🐛 Hibaelhárítás
<details>
<summary><b>Kattintson a hibaelhárítási útmutató kibontásához</b></summary>
**"A nyelvi modell nem adott üzenetet"**
- A szolgáltatói kvóta kimerült → Ellenőrizze az irányítópult kvótakövetőjét
- Megoldás: Használjon kombinált tartalékot, vagy váltson olcsóbb szintre
**Drátakorlát**
- Előfizetési kvóta lejárt → Tartalék a GLM/MiniMax-hoz
- Kombinó hozzáadása: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**OAuth token lejárt**
- Az OmniRoute automatikusan frissíti
- Ha a problémák továbbra is fennállnak: Irányítópult → Szolgáltató → Újracsatlakozás
**Magas költségek**
- Ellenőrizze a használati statisztikákat az Irányítópult → Költségek menüpontban
- Állítsa át az elsődleges modellt GLM/MiniMax-ra
- Használjon ingyenes réteget (Gemini CLI, iFlow) a nem kritikus feladatokhoz
**A műszerfal rossz porton nyílik meg**
- `PORT=20128` és `NEXT_PUBLIC_BASE_URL=http://localhost:20128` beállítása
**Felhő szinkronizálási hibák**
- Ellenőrizze, hogy `BASE_URL` mutat a futó példányra
- Ellenőrizzen `CLOUD_URL` pontot a várható felhő-végponthoz
- Tartsa az `NEXT_PUBLIC_*` értékeket a szerveroldali értékekkel összhangban
**Az első bejelentkezés nem működik**
- Ellenőrizze a `INITIAL_PASSWORD`-t itt: `.env`
- Ha nincs beállítva, a tartalék jelszó: `123456`
**Nincs kérésnapló**
- Állítsa be `ENABLE_REQUEST_LOGS=true` a `.env`-ban
**A csatlakozási teszt „Érvénytelen” üzenetet mutat az OpenAI-kompatibilis szolgáltatók esetében**
- Sok szolgáltató nem tesz közzé `/models` végpontot
- Az OmniRoute v1.0.6+ tartalmazza a tartalék érvényesítést a csevegés befejezésén keresztül
- Győződjön meg arról, hogy az alap URL tartalmazza a `/v1` utótagot
</details>
---
@@ -1176,85 +1104,6 @@ MIT-licenc a részletekért lásd: [LICENSE](LICENSE).
---
---
## 🇧🇷 OmniRoute — IA ingyenes átjáró
<a name="-omniroute--gateway-de-ia-gratuito"></a>
### Nunca pare de codar. Roteamento inteligente para **modelos de IA GRATUITOS e de baixo custo** com backback automatico.
_Seu proxy univerzális API um végpont, 36+ gyártó, nulla leállás._
### 🌐 Internacionalização (i18n)
O dashboard do OmniRoute támogatja a **múltiplos idiomas**. Atualmente disponível em:
| Idioma | Código | Állapot |
| --------------------- | ------- | ----------- |
| 🇺🇸 angol | `en` | ✅ Completo |
| 🇧🇷 Português (Brasil) | `pt-BR` | ✅ Completo |
**Para trocar o idioma:** Clique no seletor de idioma (🇺🇸 EN) no header do dashboard → Selectione o idioma desejado.
**Para adicionar um novo idioma:**
1. Sírj `src/i18n/messages/{codigo}.json` baseado em `en.json`
2. Adicione o código em `src/i18n/config.ts``LOCALES` e `LANGUAGES`
3. Reinicie o servidor
### ⚡ Início Rápido
```bash
# Instalar via npm
npx omniroute@latest
# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
```
### 🐳 Docker
```bash
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
```
### 🔑 Funcionalidades Principais
- **36+ IA produkátor** Claude, GPT, Gemini, Llama, Qwen, DeepSeek, e mais
- **Roteamento inteligente** — Fallback automatico entre provedores
- **Tradução de formato** — OpenAI ↔ Claude ↔ Gemini automatamente
- **Multi-conta** — Múltiplas contas por provedor com seleção inteligente
- **Cache szemântico** Reduz custos e latência
- **OAuth automatico** — Tokens renovam automaticamente
- **Combos personalizados** - 6 estratégias de roteamento
- **Befejezett irányítópult** - Monitoring, naplók, elemzések, konfigurációk
- **CLI eszközök** — Claude Code, Codex, Cursor, Cline com um clique konfigurálása
- **100% TypeScript** Código limpo e tipado
### 📖 Documentação
| Documento | Leírás |
| ----------------------------------------------- | -------------------------------------- |
| [Guia do Usuário](docs/USER_GUIDE.md) | Provedores, kombók, CLI, telepítés |
| [Referência da API](docs/API_REFERENCE.md) | Todos os végpontok com exemplos |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Problemas comuns e soluções |
| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura e internos do sistema |
| [Contribuição](CONTRIBUTING.md) | Setup de desenvolvimento e Guidelines |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Teljes verzió: VM + nginx + Cloudflare |
### 📧 Támogatás
> 💬 **Entre para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tire dúvidas, compartilhe dicas e fique atualizado.
- **Webhely**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Problémák**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
---
<div align="center">
<sub>A ❤️ segítségével készült a 24/7 kódoló fejlesztőknek</sub>
<br/>

View File

@@ -3,8 +3,6 @@
# 🚀 OmniRoute — Gerbang AI Gratis
🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
### Jangan pernah berhenti membuat kode. Perutean cerdas ke **model AI GRATIS & berbiaya rendah** dengan fallback otomatis.
_Proksi API universal Anda — satu titik akhir, 36+ penyedia, tanpa waktu henti._
@@ -298,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Kasus Penggunaan
### Kasus 1: "Saya berlangganan Claude Pro"
**Masalah:** Kuota habis tanpa terpakai, batas kecepatan selama coding berat
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Kasus 2: "Saya ingin tanpa biaya"
**Masalah:** Tidak mampu berlangganan, memerlukan pengkodean AI yang andal
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Kasus 3: "Saya memerlukan pengkodean 24/7, tanpa gangguan"
**Masalah:** Tenggat waktu, tidak mampu membayar downtime
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Kasus 4: "Saya ingin AI GRATIS di OpenClaw"
**Masalah:** Membutuhkan asisten AI dalam aplikasi perpesanan, sepenuhnya gratis
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Fitur Utama
### 🧠 Perutean & Kecerdasan Inti
@@ -519,6 +456,67 @@ OmniRoute menyertakan Taman Bermain Penerjemah bawaan yang canggih dengan **4 mo
---
## 🎯 Kasus Penggunaan
### Kasus 1: "Saya berlangganan Claude Pro"
**Masalah:** Kuota habis tanpa terpakai, batas kecepatan selama coding berat
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Kasus 2: "Saya ingin tanpa biaya"
**Masalah:** Tidak mampu berlangganan, memerlukan pengkodean AI yang andal
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Kasus 3: "Saya memerlukan pengkodean 24/7, tanpa gangguan"
**Masalah:** Tenggat waktu, tidak mampu membayar downtime
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Kasus 4: "Saya ingin AI GRATIS di OpenClaw"
**Masalah:** Membutuhkan asisten AI dalam aplikasi perpesanan, sepenuhnya gratis
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Panduan Pengaturan
<details>
@@ -799,74 +797,6 @@ Settings → API Configuration:
---
## 📊 Model yang Tersedia
<details>
<summary><b>Lihat semua model yang tersedia</b></summary>
**Kode Claude (`cc/`)** - Pro/Maks:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Kodeks (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - GRATIS:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**Copilot GitHub (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - Kredit GRATIS:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- 50+ model lainnya di [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - $0,6/1 juta:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - $0,2/1 juta:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - GRATIS:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - GRATIS:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - GRATIS:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100+ model:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Model apa pun dari [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Evaluasi (Eval)
OmniRoute menyertakan kerangka evaluasi bawaan untuk menguji kualitas respons LLM terhadap rangkaian emas. Akses melalui **Analytics → Evals** di dasbor.
@@ -890,7 +820,58 @@ OmniRoute menyertakan kerangka evaluasi bawaan untuk menguji kualitas respons LL
---
## 🔐 OAuth em Servidor Remoto (Pengaturan OAuth Jarak Jauh)
## 🐛 Pemecahan masalah
<details>
<summary><b>Klik untuk memperluas panduan pemecahan masalah</b></summary>
**"Model bahasa tidak memberikan pesan"**
- Kuota penyedia habis → Periksa dashboard pelacak kuota
- Solusi: Gunakan combo fallback atau beralih ke tier yang lebih murah
**Pembatasan tarif**
- Kuota berlangganan habis → Penggantian ke GLM/MiniMax
- Tambahkan kombo: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**Token OAuth kedaluwarsa**
- Disegarkan secara otomatis oleh OmniRoute
- Jika masalah terus berlanjut: Dasbor → Penyedia → Sambungkan kembali
**Biaya tinggi**
- Periksa statistik penggunaan di Dashboard → Biaya
- Ganti model utama ke GLM/MiniMax
- Gunakan tingkat gratis (Gemini CLI, iFlow) untuk tugas-tugas yang tidak penting
**Dasbor terbuka pada port yang salah**
- Tetapkan `PORT=20128` dan `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Kesalahan sinkronisasi cloud**
- Verifikasi `BASE_URL` poin ke instance Anda yang sedang berjalan
- Verifikasi `CLOUD_URL` poin ke titik akhir cloud yang Anda harapkan
- Jaga agar nilai `NEXT_PUBLIC_*` selaras dengan nilai sisi server
**Login pertama tidak berfungsi**
- Periksa `INITIAL_PASSWORD` di `.env`
- Jika tidak disetel, kata sandi cadangan adalah `123456`
**Tidak ada log permintaan**
- Tetapkan `ENABLE_REQUEST_LOGS=true` di `.env`
**Tes koneksi menunjukkan "Tidak Valid" untuk penyedia yang kompatibel dengan OpenAI**
- Banyak penyedia tidak mengekspos titik akhir `/models`
- OmniRoute v1.0.6+ menyertakan validasi fallback melalui penyelesaian obrolan
- Pastikan URL dasar menyertakan akhiran `/v1`
### 🔐 OAuth em Servidor Remoto (Pengaturan OAuth Jarak Jauh)
<a name="oauth-em-servidor-remoto"></a>
@@ -981,59 +962,6 @@ Jika Anda tidak ingin membuat kredensial pribadi sekarang, Anda mungkin dapat me
> Solusi ini berfungsi karena kode otorisasi pada URL valid secara independen untuk mengarahkan ulang ke akun atau tidak.
---
## 🐛 Pemecahan masalah
<details>
<summary><b>Klik untuk memperluas panduan pemecahan masalah</b></summary>
**"Model bahasa tidak memberikan pesan"**
- Kuota penyedia habis → Periksa dashboard pelacak kuota
- Solusi: Gunakan combo fallback atau beralih ke tier yang lebih murah
**Pembatasan tarif**
- Kuota berlangganan habis → Penggantian ke GLM/MiniMax
- Tambahkan kombo: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**Token OAuth kedaluwarsa**
- Disegarkan secara otomatis oleh OmniRoute
- Jika masalah terus berlanjut: Dasbor → Penyedia → Sambungkan kembali
**Biaya tinggi**
- Periksa statistik penggunaan di Dashboard → Biaya
- Ganti model utama ke GLM/MiniMax
- Gunakan tingkat gratis (Gemini CLI, iFlow) untuk tugas-tugas yang tidak penting
**Dasbor terbuka pada port yang salah**
- Tetapkan `PORT=20128` dan `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Kesalahan sinkronisasi cloud**
- Verifikasi `BASE_URL` poin ke instance Anda yang sedang berjalan
- Verifikasi `CLOUD_URL` poin ke titik akhir cloud yang Anda harapkan
- Jaga agar nilai `NEXT_PUBLIC_*` selaras dengan nilai sisi server
**Login pertama tidak berfungsi**
- Periksa `INITIAL_PASSWORD` di `.env`
- Jika tidak disetel, kata sandi cadangan adalah `123456`
**Tidak ada log permintaan**
- Tetapkan `ENABLE_REQUEST_LOGS=true` di `.env`
**Tes koneksi menunjukkan "Tidak Valid" untuk penyedia yang kompatibel dengan OpenAI**
- Banyak penyedia tidak mengekspos titik akhir `/models`
- OmniRoute v1.0.6+ menyertakan validasi fallback melalui penyelesaian obrolan
- Pastikan URL dasar menyertakan akhiran `/v1`
</details>
---
@@ -1176,85 +1104,6 @@ Lisensi MIT - lihat [LICENSE](LICENSE) untuk detailnya.
---
---
## 🇧🇷 OmniRoute — Gerbang IA Gratis
<a name="-omniroute--gateway-de-ia-gratuito"></a>
### Tidak ada kode apa pun. Roteamento cerdas untuk **model IA GRATIS dan hak istimewa** dengan fallback otomatis.
_Proksi universal API — um titik akhir, 36+ bukti, tanpa waktu henti._
### 🌐 Internasionalisasi (i18n)
Pada dasbor, lakukan OmniRoute mendukung **beberapa idiom**. Saat ini kami telah membagikannya:
| Idiom | Kode | Status |
| --------------------- | ------- | ---------- |
| 🇮🇩 Bahasa Inggris | `en` | ✅ Lengkap |
| 🇧🇷 Português (Brasil) | `pt-BR` | ✅ Lengkap |
**Untuk trocar o idioma:** Klik no selector de idioma (🇮🇩 EN) no header do dashboard → pilih idioma yang diinginkan.
**Untuk menambahkan idiom baru:**
1. Teriak `src/i18n/messages/{codigo}.json` berdasarkan `en.json`
2. Tambahan kode pada `src/i18n/config.ts``LOCALES` dan `LANGUAGES`
3. Memulai kembali server
### ⚡ Mulai Cepat
```bash
# Instalar via npm
npx omniroute@latest
# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
```
### 🐳 buruh pelabuhan
```bash
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
```
### 🔑 Prinsip Fungsionalidades
- **36+ bukti IA** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek, dan lainnya
- **Roteamento inteligente** — Penggantian otomatis ke seluruh bukti
- **Penulisan format** — OpenAI ↔ Claude ↔ Gemini secara otomatis
- **Multi-konta** — Multi-konta berdasarkan pilihan yang cerdas
- **Cache semântico** — Memulihkan biaya dan latensi
- **OAuth otomatis** — Token diperbarui secara otomatis
- **Kombo yang dipersonalisasi** — 6 strategi roteamento
- **Dasbor lengkap** — Monitor, log, analisis, konfigurasi
- **Alat CLI** — Konfigurasikan Kode Claude, Codex, Kursor, Cline com um klik
- **100% TypeScript** — Kode limpo dan tipado
### 📖 Dokumentasi
| Dokumen | Deskripsi |
| ----------------------------------------------- | ---------------------------------------- |
| [Guia do Usuário](docs/USER_GUIDE.md) | Provedores, kombo, CLI, terapkan |
| [Referência da API](docs/API_REFERENCE.md) | Semua titik akhir dengan contoh |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Masalah Umum dan Solusi |
| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura dan internal dalam sistem |
| [Contribuição](CONTRIBUTING.md) | Menyiapkan pedoman desenvolvimento |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Panduan lengkap: VM + nginx + Cloudflare |
### 📧 Dukungan
> 💬 **Entre to a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Ban dúvidas, compartilhe dicas dan fique aktualizado.
- **Situs Web**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Masalah**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
---
<div align="center">
<sub>Dibangun dengan ❤️ untuk pengembang yang membuat kode 24/7</sub>
<br/>

View File

@@ -193,57 +193,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 उपयोग के मामले
### केस 1: "मेरे पास क्लाउड प्रो सदस्यता है"
**समस्या:** भारी कोडिंग के दौरान कोटा अप्रयुक्त, दर सीमा समाप्त हो जाता है
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### केस 2: "मुझे शून्य लागत चाहिए"
**समस्या:** सदस्यताएं वहन नहीं कर सकते, विश्वसनीय एआई कोडिंग की आवश्यकता है
### केस 3: "मुझे 24/7 कोडिंग चाहिए, कोई रुकावट नहीं"
**समस्या:** समय सीमा, डाउनटाइम बर्दाश्त नहीं कर सकते
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### केस 4: "मुझे ओपनक्लॉ में मुफ़्त एआई चाहिए"
**समस्या:** मैसेजिंग ऐप्स में AI सहायक की आवश्यकता है, पूरी तरह से निःशुल्क
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 मुख्य विशेषताएं
### 🧠 कोर रूटिंग और इंटेलिजेंस
@@ -391,6 +340,57 @@ Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
---
## 🎯 उपयोग के मामले
### केस 1: "मेरे पास क्लाउड प्रो सदस्यता है"
**समस्या:** भारी कोडिंग के दौरान कोटा अप्रयुक्त, दर सीमा समाप्त हो जाता है
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### केस 2: "मुझे शून्य लागत चाहिए"
**समस्या:** सदस्यताएं वहन नहीं कर सकते, विश्वसनीय एआई कोडिंग की आवश्यकता है
### केस 3: "मुझे 24/7 कोडिंग चाहिए, कोई रुकावट नहीं"
**समस्या:** समय सीमा, डाउनटाइम बर्दाश्त नहीं कर सकते
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### केस 4: "मुझे ओपनक्लॉ में मुफ़्त एआई चाहिए"
**समस्या:** मैसेजिंग ऐप्स में AI सहायक की आवश्यकता है, पूरी तरह से निःशुल्क
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 सेटअप गाइड
<summary><b>💳 सदस्यता प्रदाता</b></summary>
@@ -616,95 +616,6 @@ Cost: $0 forever!
---
## 🔐 OAuth em सर्विडोर रेमोटो (रिमोट OAuth सेटअप)
<a name="oauth-em-servidor-remoto"></a>
> **⚠️ वीपीएस/डॉकर/सर्विडोर रिमोट पर ओमनीरूट का उपयोग करने के लिए महत्वपूर्ण**
### क्या आप एंटीग्रेविटी/जेमिनी सीएलआई के लिए OAuth का उपयोग कर रहे हैं?
प्रमाणित करने के लिए **एंटीग्रेविटी** और **मिथुन सीएलआई** का उपयोग करें **Google OAuth 2.0** का उपयोग करें। Google के लिए यह आवश्यक है कि `redirect_uri` का उपयोग बिना किसी प्रवाह के OAuth सेजा **exatamente** के माध्यम से किया जाए ताकि URIs को Google क्लाउड कंसोल के लिए पूर्व-आवेदन किया जा सके।
जैसा कि OAuth का प्रमाण है, कोई ओम्निरूट कैडस्ट्राड नहीं है ** `localhost`** के लिए एपेनास। एक सर्विडोर रिमोट (उदा: `https://omniroute.meuservidor.com`) पर ओमनीरूट का उपयोग कैसे करें, या Google एक प्रमाणीकरण कॉम को पुनः प्राप्त करता है:
### समाधान: OAuth को कॉन्फ़िगर करें
आपका सटीक विवरण **OAuth 2.0 क्लाइंट आईडी** आपके सर्वर पर यूआरआई के साथ Google क्लाउड कंसोल नहीं है।
#### पासो ए पासो
**1. Google क्लाउड कंसोल तक पहुंच**
अब्राहम: [https://console.cloud.google.com/apis/credentials](https://console.cloud.google.com/apis/credentials)
**2. नया OAuth 2.0 क्लाइंट आईडी देखें**
- उन्हें क्लिक करें **"+ क्रेडेंशियल बनाएं"** → **"OAuth क्लाइंट आईडी"**
- आवेदन टिप: **"वेब एप्लिकेशन"**
- नोम: एस्कोल्हा क्वाल्कर नोम (उदा: `OmniRoute Remote`)
**3. अधिकृत रीडायरेक्ट यूआरआई के रूप में एडिकियोन**
कोई शिकायत नहीं **"अधिकृत रीडायरेक्ट यूआरआई"**, आदि:
```
https://seu-servidor.com/callback
```
> स्थानापन्न `seu-servidor.com` अपने आईपी को अपने सर्वर पर रखें (इसमें एक आवश्यक पोर्ट भी शामिल है, उदाहरण के लिए: `http://45.33.32.156:20128/callback`)।
**4. साख के रूप में सहेजें और कॉपी करें**
एपोस क्रियर, Google द्वारा **क्लाइंट आईडी** और **क्लाइंट सीक्रेट**
**5. परिवेश परिवर्तन** के रूप में कॉन्फ़िगर करें
कोई `.env` नहीं (आप डॉकर के परिवेश को कैसे बदल सकते हैं):
```bash
# Para Antigravity:
ANTIGRAVITY_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret
# Para Gemini CLI:
GEMINI_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
GEMINI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret
GEMINI_CLI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret
```
**6. ओम्निरूट का नवीनीकरण**
```bash
# Se usando npm:
npm run dev
# Se usando Docker:
docker restart omniroute
```
**7. नए सिरे से संपर्क करें**
डैशबोर्ड → प्रदाता → एंटीग्रेविटी (या जेमिनी सीएलआई) → OAuth
`https://seu-servidor.com/callback` और एक प्रमाणीकरण कार्य के लिए Google पुनर्निर्देशन।
---
### वर्कअराउंड टेम्पोरैरियो (सेम कॉन्फिगरेशन क्रेडेंशियल प्रोप्रियास)
यदि आप पहले से ही उचित क्रेडेंशियल प्राप्त नहीं करना चाहते हैं, तो आपके लिए फ्लक्सो का उपयोग करना संभव है **यूआरएल का मैनुअल**:
1. Google पर स्वचालित URL का उपयोग करके ओम्निरूट का उपयोग करें
2. ऑटोरिज़ार का लाभ, `localhost` के लिए Google पुनर्निर्देशन (यदि कोई सर्वर रिमोट नहीं है)
3. **एक यूआरएल को पूरा कॉपी करें** अपने ब्राउजर से दोबारा डाउनलोड करें (मुझे लगता है कि एक पेज अभी भी उपलब्ध है)
4. ओम्निरूट से जुड़ने के लिए कोई भी यूआरएल नहीं है
5. उन्हें क्लिक करें **"कनेक्ट"**
> यह समाधान यूआरएल को स्वचालित रूप से डाउनलोड करने के लिए काम कर रहा है और आपके द्वारा किए गए रीडायरेक्ट को स्वतंत्र रूप से वैध बनाता है।
---
## 🐛 समस्या निवारण
<summary><b>समस्या निवारण मार्गदर्शिका का विस्तार करने के लिए क्लिक करें</b></summary>

View File

@@ -296,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Casi d'Uso
### Caso 1: "Ho un abbonamento Claude Pro"
**Problema:** La quota scade inutilizzata, limiti di rate durante la programmazione intensa
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (usa l'abbonamento al massimo)
2. glm/glm-4.7 (backup economico quando la quota è esaurita)
3. if/kimi-k2-thinking (fallback d'emergenza gratuito)
Costo mensile: $20 (abbonamento) + ~$5 (backup) = $25 totale
vs. $20 + sbattere contro i limiti = frustrazione
```
### Caso 2: "Voglio costo zero"
**Problema:** Non può permettersi abbonamenti, ha bisogno di IA affidabile per programmare
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K gratis/mese)
2. if/kimi-k2-thinking (illimitato gratis)
3. qw/qwen3-coder-plus (illimitato gratis)
Costo mensile: $0
Qualità: Modelli pronti per la produzione
```
### Caso 3: "Devo programmare 24/7, senza interruzioni"
**Problema:** Scadenze strette, non può permettersi downtime
```
Combo: "always-on"
1. cc/claude-opus-4-6 (migliore qualità)
2. cx/gpt-5.2-codex (secondo abbonamento)
3. glm/glm-4.7 (economico, reset giornaliero)
4. minimax/MiniMax-M2.1 (più economico, reset 5h)
5. if/kimi-k2-thinking (gratuito illimitato)
Risultato: 5 livelli di fallback = zero downtime
```
### Caso 4: "Voglio IA GRATUITA in OpenClaw"
**Problema:** Ha bisogno di assistente IA nelle app di messaggistica, completamente gratuito
```
Combo: "openclaw-free"
1. if/glm-4.7 (illimitato gratis)
2. if/minimax-m2.1 (illimitato gratis)
3. if/kimi-k2-thinking (illimitato gratis)
Costo mensile: $0
Accesso via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Funzionalità Principali
### 🧠 Routing & Intelligenza
@@ -498,6 +437,67 @@ Traduzione trasparente tra formati:
---
## 🎯 Casi d'Uso
### Caso 1: "Ho un abbonamento Claude Pro"
**Problema:** La quota scade inutilizzata, limiti di rate durante la programmazione intensa
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (usa l'abbonamento al massimo)
2. glm/glm-4.7 (backup economico quando la quota è esaurita)
3. if/kimi-k2-thinking (fallback d'emergenza gratuito)
Costo mensile: $20 (abbonamento) + ~$5 (backup) = $25 totale
vs. $20 + sbattere contro i limiti = frustrazione
```
### Caso 2: "Voglio costo zero"
**Problema:** Non può permettersi abbonamenti, ha bisogno di IA affidabile per programmare
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K gratis/mese)
2. if/kimi-k2-thinking (illimitato gratis)
3. qw/qwen3-coder-plus (illimitato gratis)
Costo mensile: $0
Qualità: Modelli pronti per la produzione
```
### Caso 3: "Devo programmare 24/7, senza interruzioni"
**Problema:** Scadenze strette, non può permettersi downtime
```
Combo: "always-on"
1. cc/claude-opus-4-6 (migliore qualità)
2. cx/gpt-5.2-codex (secondo abbonamento)
3. glm/glm-4.7 (economico, reset giornaliero)
4. minimax/MiniMax-M2.1 (più economico, reset 5h)
5. if/kimi-k2-thinking (gratuito illimitato)
Risultato: 5 livelli di fallback = zero downtime
```
### Caso 4: "Voglio IA GRATUITA in OpenClaw"
**Problema:** Ha bisogno di assistente IA nelle app di messaggistica, completamente gratuito
```
Combo: "openclaw-free"
1. if/glm-4.7 (illimitato gratis)
2. if/minimax-m2.1 (illimitato gratis)
3. if/kimi-k2-thinking (illimitato gratis)
Costo mensile: $0
Accesso via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Guida alla Configurazione
<details>
@@ -778,74 +778,6 @@ Impostazioni → Configurazione API:
---
## 📊 Modelli Disponibili
<details>
<summary><b>Vedi tutti i modelli disponibili</b></summary>
**Claude Code (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Codex (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - GRATUITO:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub Copilot (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - Crediti GRATUITI:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- 50+ modelli su [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - $0.6/1M:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - $0.2/1M:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - GRATUITO:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - GRATUITO:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - GRATUITO:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100+ modelli:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Qualsiasi modello da [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Valutazioni (Evals)
OmniRoute include un framework di valutazione integrato per testare la qualità delle risposte LLM contro un golden set. Accesso via **Analytics → Evals** nella dashboard.

View File

@@ -296,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 使用例
### ケース 1: 「Claude Pro サブスクリプションを持っています」
**問題:** 大量のコーディング中にクォータが使用されずに期限切れになり、レート制限が発生する
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### ケース 2: 「コストをゼロにしたい」
**問題:** サブスクリプションを購入する余裕がないため、信頼性の高い AI コーディングが必要です
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### ケース 3: 「24 時間年中無休でコーディングが必要で、中断はありません」
**問題:** 締め切りが迫っており、ダウンタイムを許すことができません
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### ケース 4: 「OpenClaw に無料の AI が欲しい」
**問題:** メッセージング アプリには AI アシスタントが必要ですが、完全に無料です
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 主な機能
### 🧠 コアルーティングとインテリジェンス
@@ -517,6 +456,67 @@ OmniRoute には、API 翻訳のデバッグ、テスト、監視のための **
---
## 🎯 使用例
### ケース 1: 「Claude Pro サブスクリプションを持っています」
**問題:** 大量のコーディング中にクォータが使用されずに期限切れになり、レート制限が発生する
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### ケース 2: 「コストをゼロにしたい」
**問題:** サブスクリプションを購入する余裕がないため、信頼性の高い AI コーディングが必要です
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### ケース 3: 「24 時間年中無休でコーディングが必要で、中断はありません」
**問題:** 締め切りが迫っており、ダウンタイムを許すことができません
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### ケース 4: 「OpenClaw に無料の AI が欲しい」
**問題:** メッセージング アプリには AI アシスタントが必要ですが、完全に無料です
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 セットアップガイド
<details>
@@ -796,74 +796,6 @@ Settings → API Configuration:
---
## 📊 利用可能なモデル
<details>
<summary><b>利用可能なモデルをすべて表示</b></summary>
**クロード コード (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**コーデックス (`cx/`)** - プラス/プロ:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - 無料:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub コパイロット (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - 無料クレジット:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- [build.nvidia.com](https://build.nvidia.com) には 50 以上のモデル
**GLM (`glm/`)** - 0.6 ドル/100 万:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - $0.2/100 万:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - 無料:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**クウェン (`qw/`)** - 無料:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**キロ (`kr/`)** - 無料:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100 以上のモデル:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- [openrouter.ai/models](https://openrouter.ai/models) の任意のモデル
</details>
---
## 🧪 評価 (Evals)
OmniRoute には、ゴールデン セットに対して LLM 応答品質をテストするための評価フレームワークが組み込まれています。ダッシュボードの **Analytics → Evals** からアクセスします。
@@ -887,7 +819,58 @@ OmniRoute には、ゴールデン セットに対して LLM 応答品質をテ
---
## 🔐 サーバーリモートの OAuth (リモート OAuth セットアップ)
## 🐛 トラブルシューティング
<details>
<summary><b>クリックしてトラブルシューティング ガイドを展開</b></summary>
**「言語モデルがメッセージを提供しませんでした」**
- プロバイダー クォータが枯渇した → ダッシュボード クォータ トラッカーを確認してください
- 解決策: コンボフォールバックを使用するか、より安価なレベルに切り替える
**レート制限**
- サブスクリプション クォータ アウト → GLM/MiniMax へのフォールバック
- コンボを追加: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**OAuth トークンの有効期限が切れました**
- OmniRouteによる自動更新
- 問題が解決しない場合: ダッシュボード → プロバイダー → 再接続
**高コスト**
- [ダッシュボード] → [コスト] で使用状況の統計を確認します。
- プライマリ モデルを GLM/MiniMax に切り替えます
- 重要ではないタスクには無料枠 (Gemini CLI、iFlow) を使用する
**ダッシュボードが間違ったポートで開きます**
- `PORT=20128` および `NEXT_PUBLIC_BASE_URL=http://localhost:20128` を設定します
**クラウド同期エラー**
- `BASE_URL` が実行中のインスタンスを指していることを確認します
- `CLOUD_URL` が予想されるクラウド エンドポイントを指していることを確認します
- `NEXT_PUBLIC_*` 値をサーバー側の値と一致させます。
**最初のログインが機能しない**
- `.env``INITIAL_PASSWORD` を確認してください
- 設定されていない場合、フォールバック パスワードは `123456` です
**リクエストログなし**
- `.env``ENABLE_REQUEST_LOGS=true` を設定します
**OpenAI 互換プロバイダーの接続テストで「無効」と表示される**
- 多くのプロバイダーは `/models` エンドポイントを公開していません
- OmniRoute v1.0.6+ には、チャット完了によるフォールバック検証が含まれています
- ベース URL に `/v1` サフィックスが含まれていることを確認してください
### 🔐 サーバーリモートの OAuth (リモート OAuth セットアップ)
<a name="oauth-em-servidor-remoto"></a>
@@ -978,59 +961,6 @@ docker restart omniroute
> 自動回避策の機能は URL から独立してリダイレクトされます。
---
## 🐛 トラブルシューティング
<details>
<summary><b>クリックしてトラブルシューティング ガイドを展開</b></summary>
**「言語モデルがメッセージを提供しませんでした」**
- プロバイダー クォータが枯渇した → ダッシュボード クォータ トラッカーを確認してください
- 解決策: コンボフォールバックを使用するか、より安価なレベルに切り替える
**レート制限**
- サブスクリプション クォータ アウト → GLM/MiniMax へのフォールバック
- コンボを追加: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**OAuth トークンの有効期限が切れました**
- OmniRouteによる自動更新
- 問題が解決しない場合: ダッシュボード → プロバイダー → 再接続
**高コスト**
- [ダッシュボード] → [コスト] で使用状況の統計を確認します。
- プライマリ モデルを GLM/MiniMax に切り替えます
- 重要ではないタスクには無料枠 (Gemini CLI、iFlow) を使用する
**ダッシュボードが間違ったポートで開きます**
- `PORT=20128` および `NEXT_PUBLIC_BASE_URL=http://localhost:20128` を設定します
**クラウド同期エラー**
- `BASE_URL` が実行中のインスタンスを指していることを確認します
- `CLOUD_URL` が予想されるクラウド エンドポイントを指していることを確認します
- `NEXT_PUBLIC_*` 値をサーバー側の値と一致させます。
**最初のログインが機能しない**
- `.env``INITIAL_PASSWORD` を確認してください
- 設定されていない場合、フォールバック パスワードは `123456` です
**リクエストログなし**
- `.env``ENABLE_REQUEST_LOGS=true` を設定します
**OpenAI 互換プロバイダーの接続テストで「無効」と表示される**
- 多くのプロバイダーは `/models` エンドポイントを公開していません
- OmniRoute v1.0.6+ には、チャット完了によるフォールバック検証が含まれています
- ベース URL に `/v1` サフィックスが含まれていることを確認してください
</details>
---

View File

@@ -3,8 +3,6 @@
# 🚀 OmniRoute — 무료 AI 게이트웨이
🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
### 코딩을 멈추지 마세요. 자동 폴백을 통해 **무료 및 저가형 AI 모델**로 스마트 라우팅합니다.
_범용 API 프록시 — 하나의 엔드포인트, 36개 이상의 공급자, 가동 중지 시간 없음._
@@ -298,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 사용 사례
### 사례 1: "Claude Pro를 구독하고 있습니다."
**문제:** 할당량은 사용되지 않은 상태로 만료되며, 코딩 작업이 많은 동안 속도 제한이 발생합니다.
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### 사례 2: "비용이 0이길 원합니다"
**문제:** 구독료를 감당할 수 없고 안정적인 AI 코딩이 필요함
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### 사례 3: "중단 없이 연중무휴 코딩이 필요합니다."
**문제:** 마감일, 가동 중지 시간을 감당할 수 없음
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### 사례 4: "OpenClaw에서 무료 AI를 원합니다"
**문제:** 메시징 앱에 AI 도우미가 필요하며 완전 무료입니다.
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 주요 기능
### 🧠 코어 라우팅 및 인텔리전스
@@ -519,6 +456,67 @@ OmniRoute에는 API 번역 디버깅, 테스트 및 모니터링을 위한 **4
---
## 🎯 사용 사례
### 사례 1: "Claude Pro를 구독하고 있습니다."
**문제:** 할당량은 사용되지 않은 상태로 만료되며, 코딩 작업이 많은 동안 속도 제한이 발생합니다.
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### 사례 2: "비용이 0이길 원합니다"
**문제:** 구독료를 감당할 수 없고 안정적인 AI 코딩이 필요함
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### 사례 3: "중단 없이 연중무휴 코딩이 필요합니다."
**문제:** 마감일, 가동 중지 시간을 감당할 수 없음
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### 사례 4: "OpenClaw에서 무료 AI를 원합니다"
**문제:** 메시징 앱에 AI 도우미가 필요하며 완전 무료입니다.
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 설정 가이드
<details>
@@ -799,74 +797,6 @@ Settings → API Configuration:
---
## 📊 사용 가능한 모델
<details>
<summary><b>사용 가능한 모든 모델 보기</b></summary>
**Claude 코드(`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**코덱스(`cx/`)** - 플러스/프로:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI(`gc/`)** - 무료:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub 부조종사(`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM(`nvidia/`)** - 무료 크레딧:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- [build.nvidia.com](https://build.nvidia.com)의 50개 이상의 모델
**GLM(`glm/`)** - $0.6/1M:
- `glm/glm-4.7`
**MiniMax(`minimax/`)** - $0.2/1M:
- `minimax/MiniMax-M2.1`
**iFlow(`if/`)** - 무료:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen(`qw/`)** - 무료:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**키로(`kr/`)** - 무료:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter(`or/`)** - 100개 이상의 모델:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- [openrouter.ai/models](https://openrouter.ai/models)의 모든 모델
</details>
---
## 🧪 평가(Evals)
OmniRoute에는 골든 세트에 대해 LLM 응답 품질을 테스트하기 위한 내장 평가 프레임워크가 포함되어 있습니다. 대시보드의 **분석 → 평가**를 통해 액세스하세요.
@@ -890,7 +820,58 @@ OmniRoute에는 골든 세트에 대해 LLM 응답 품질을 테스트하기 위
---
## 🔐 OAuth em Servidor Remoto(원격 OAuth 설정)
## 🐛 문제 해결
<details>
<summary><b>문제 해결 가이드를 확장하려면 클릭하세요</b></summary>
**"언어 모델이 메시지를 제공하지 않았습니다"**
- 공급자 할당량 소진 → 대시보드 할당량 추적기 확인
- 해결 방법: 콤보 폴백을 사용하거나 더 저렴한 계층으로 전환하세요.
**비율 제한**
- 구독 할당량 초과 → GLM/MiniMax로 대체
- 콤보 추가: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**OAuth 토큰이 만료되었습니다**
- OmniRoute에 의해 자동 새로고침
- 문제가 지속되는 경우: Dashboard → Provider → Reconnect
**높은 비용**
- 대시보드 → 비용에서 사용 통계를 확인하세요.
- 기본 모델을 GLM/MiniMax로 전환
- 중요하지 않은 작업에는 무료 계층(Gemini CLI, iFlow)을 사용합니다.
**대시보드가 잘못된 포트에서 열립니다**
- `PORT=20128``NEXT_PUBLIC_BASE_URL=http://localhost:20128` 설정
**클라우드 동기화 오류**
- `BASE_URL`이 실행 중인 인스턴스를 가리키는지 확인합니다.
- `CLOUD_URL`이 예상 클라우드 엔드포인트를 가리키는지 확인하세요.
- `NEXT_PUBLIC_*` 값을 서버측 값과 일치하도록 유지합니다.
**첫 번째 로그인이 작동하지 않습니다**
- `.env`에서 `INITIAL_PASSWORD`을 확인하세요.
- 설정되지 않은 경우 대체 비밀번호는 `123456`입니다.
**요청 로그 없음**
- `.env``ENABLE_REQUEST_LOGS=true`을 설정합니다.
**OpenAI 호환 공급자에 대한 연결 테스트에서 "잘못됨"이 표시됩니다**
- 많은 공급자가 `/models` 엔드포인트를 노출하지 않습니다.
- OmniRoute v1.0.6+에는 채팅 완료를 통한 대체 검증이 포함되어 있습니다.
- 기본 URL에 `/v1` 접미사가 포함되어 있는지 확인하세요.
### 🔐 OAuth em Servidor Remoto(원격 OAuth 설정)
<a name="oauth-em-servidor-remoto"></a>
@@ -981,59 +962,6 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux
> 이 해결 방법은 URL을 통해 자동으로 코드를 확인하거나 독립적으로 리디렉션할 수 있도록 하는 것입니다.
---
## 🐛 문제 해결
<details>
<summary><b>문제 해결 가이드를 확장하려면 클릭하세요</b></summary>
**"언어 모델이 메시지를 제공하지 않았습니다"**
- 공급자 할당량 소진 → 대시보드 할당량 추적기 확인
- 해결 방법: 콤보 폴백을 사용하거나 더 저렴한 계층으로 전환하세요.
**비율 제한**
- 구독 할당량 초과 → GLM/MiniMax로 대체
- 콤보 추가: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**OAuth 토큰이 만료되었습니다**
- OmniRoute에 의해 자동 새로고침
- 문제가 지속되는 경우: Dashboard → Provider → Reconnect
**높은 비용**
- 대시보드 → 비용에서 사용 통계를 확인하세요.
- 기본 모델을 GLM/MiniMax로 전환
- 중요하지 않은 작업에는 무료 계층(Gemini CLI, iFlow)을 사용합니다.
**대시보드가 잘못된 포트에서 열립니다**
- `PORT=20128``NEXT_PUBLIC_BASE_URL=http://localhost:20128` 설정
**클라우드 동기화 오류**
- `BASE_URL`이 실행 중인 인스턴스를 가리키는지 확인합니다.
- `CLOUD_URL`이 예상 클라우드 엔드포인트를 가리키는지 확인하세요.
- `NEXT_PUBLIC_*` 값을 서버측 값과 일치하도록 유지합니다.
**첫 번째 로그인이 작동하지 않습니다**
- `.env`에서 `INITIAL_PASSWORD`을 확인하세요.
- 설정되지 않은 경우 대체 비밀번호는 `123456`입니다.
**요청 로그 없음**
- `.env``ENABLE_REQUEST_LOGS=true`을 설정합니다.
**OpenAI 호환 공급자에 대한 연결 테스트에서 "잘못됨"이 표시됩니다**
- 많은 공급자가 `/models` 엔드포인트를 노출하지 않습니다.
- OmniRoute v1.0.6+에는 채팅 완료를 통한 대체 검증이 포함되어 있습니다.
- 기본 URL에 `/v1` 접미사가 포함되어 있는지 확인하세요.
</details>
---
@@ -1176,85 +1104,6 @@ MIT 라이선스 - 자세한 내용은 [LICENSE](LICENSE)을 참조하세요.
---
---
## 🇧🇷 OmniRoute — IA 무료 게이트웨이
<a name="-omniroute--gateway-de-ia-gratuito"></a>
### Nunca pare de codar. **IA 무료 모델 및 사용자 정의**가 자동 대체 기능으로 지능화되었습니다.
_Seu 프록시 범용 API — 음 엔드포인트, 36개 이상의 Prodoores, 가동 중지 시간 없음._
### 🌐 국제화(i18n)
O 대시보드는 OmniRoute를 지원하여 **다양한 관용어**를 지원합니다. 불만이 있는 경우:
| 관용구 | 코디고 | 상태 |
| --------------------- | ------- | ------- |
| 🇺🇸 영어 | `en` | ✅ 완료 |
| 🇧🇷 포르투갈어(브라질) | `pt-BR` | ✅ 완료 |
**Para trocar o idioma:** Clique no seletor de idioma(🇺🇸 EN) 헤더 없음 대시보드 → selecione o idioma desejado.
**추가적인 표현:**
1. `src/i18n/messages/{codigo}.json` 소리 지르기 `en.json` 기반으로
2. `src/i18n/config.ts``LOCALES` e `LANGUAGES` 코드를 사용하세요.
3. Reinicie o servidor
### ⚡ 이니시오 라피도
```bash
# Instalar via npm
npx omniroute@latest
# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
```
### 🐳 도커
```bash
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
```
### 🔑 Funcionalidades Principais
- **36개 이상의 IA 인증** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek 등
- **지능형 회전** — 예비 자동 대체
- **Tradução de formato** — OpenAI ⇔ Claude ⇔ Gemini 자동 번역
- **다중 연결** — 지능적인 선택을 통해 입증된 여러 콘타스
- **캐시 의미** — Reduz custos and latência
- **OAuth 자동** — 토큰 자동 업데이트
- **맞춤형 콤보** — 6가지 기본 전략
- **대시보드 완료** — 모니터링, 로그, 분석, 구성
- **CLI 도구** — Claude Code, Codex, Cursor, Cline com um clique 구성
- **100% TypeScript** — Código limpo etipado
### 📖 문서
| 도큐멘토 | 설명 |
| ----------------------------------------------- | ------------------------------------ |
| [Guia do Usuário](docs/USER_GUIDE.md) | Provedore, 콤보, CLI, 배포 |
| [Referência da API](docs/API_REFERENCE.md) | 예를 들어 Todos OS 엔드포인트 |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | 문제 및 솔루션 문제 |
| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura e internos do sistema |
| [Contribuição](CONTRIBUTING.md) | 자유 의지 설정 지침 |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | 완전한 기능: VM + nginx + Cloudflare |
### 📧 지원
> 💬 **공동체에 참여하세요!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tire dúvidas, compartilhe dicas e fique atualizado.
- **웹사이트**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **문제**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
---
<div align="center">
<sub> 연중무휴</sub>을 코딩하는 개발자를 위해 ❤️으로 구축됨
<br/>

431
README.md
View File

@@ -3,8 +3,6 @@
# 🚀 OmniRoute — The Free AI Gateway
🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
### Never stop coding. Smart routing to **FREE & low-cost AI models** with automatic fallback.
_Your universal API proxy — one endpoint, 36+ providers, zero downtime._
@@ -13,6 +11,20 @@ _Your universal API proxy — one endpoint, 36+ providers, zero downtime._
---
[![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute)
[![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute)
[![License](https://img.shields.io/github/license/diegosouzapw/OmniRoute)](https://github.com/diegosouzapw/OmniRoute/blob/main/LICENSE)
[![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online)
[![WhatsApp](https://img.shields.io/badge/WhatsApp-Community-25D366?logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
[🌐 Website](https://omniroute.online) • [🚀 Quick Start](#-quick-start) • [💡 Features](#-key-features) • [📖 Docs](#-documentation) • [💰 Pricing](#-pricing-at-a-glance) • [💬 WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
🌐 **Available in:** 🇺🇸 [English](README.md) | 🇧🇷 [Português (Brasil)](README.pt-BR.md) | 🇪🇸 [Español](README.es.md) | 🇫🇷 [Français](README.fr.md) | 🇮🇹 [Italiano](README.it.md) | 🇷🇺 [Русский](README.ru.md) | 🇨🇳 [中文 (简体)](README.zh-CN.md) | 🇩🇪 [Deutsch](README.de.md) | 🇮🇳 [हिन्दी](README.in.md) | 🇹🇭 [ไทย](README.th.md) | 🇺🇦 [Українська](README.uk-UA.md) | 🇸🇦 [العربية](README.ar.md) | 🇯🇵 [日本語](README.ja.md) | 🇻🇳 [Tiếng Việt](README.vi.md) | 🇧🇬 [Български](README.bg.md) | 🇩🇰 [Dansk](README.da.md) | 🇫🇮 [Suomi](README.fi.md) | 🇮🇱 [עברית](README.he.md) | 🇭🇺 [Magyar](README.hu.md) | 🇮🇩 [Bahasa Indonesia](README.id.md) | 🇰🇷 [한국어](README.ko.md) | 🇲🇾 [Bahasa Melayu](README.ms.md) | 🇳🇱 [Nederlands](README.nl.md) | 🇳🇴 [Norsk](README.no.md) | 🇵🇹 [Português (Portugal)](README.pt.md) | 🇷🇴 [Română](README.ro.md) | 🇵🇱 [Polski](README.pl.md) | 🇸🇰 [Slovenčina](README.sk.md) | 🇸🇪 [Svenska](README.sv.md) | 🇵🇭 [Filipino](README.phi.md)
</div>
---
### 🤖 Free AI Provider for your favorite coding agents
_Connect any AI-powered IDE or CLI tool through OmniRoute — free API gateway for unlimited coding._
@@ -98,17 +110,15 @@ _Connect any AI-powered IDE or CLI tool through OmniRoute — free API gateway f
---
[![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute)
[![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute)
[![License](https://img.shields.io/github/license/diegosouzapw/OmniRoute)](https://github.com/diegosouzapw/OmniRoute/blob/main/LICENSE)
[![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online)
[![WhatsApp](https://img.shields.io/badge/WhatsApp-Community-25D366?logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
## 📧 Support
[🌐 Website](https://omniroute.online) • [🚀 Quick Start](#-quick-start) • [💡 Features](#-key-features) • [📖 Docs](#-documentation) • [💰 Pricing](#-pricing-at-a-glance) • [💬 WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
> 💬 **Join our community!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Get help, share tips, and stay updated.
🌐 **Available in:** 🇺🇸 [English](README.md) | 🇧🇷 [Português (Brasil)](README.pt-BR.md) | 🇪🇸 [Español](README.es.md) | 🇫🇷 [Français](README.fr.md) | 🇮🇹 [Italiano](README.it.md) | 🇷🇺 [Русский](README.ru.md) | 🇨🇳 [中文 (简体)](README.zh-CN.md) | 🇩🇪 [Deutsch](README.de.md) | 🇮🇳 [हिन्दी](README.in.md) | 🇹🇭 [ไทย](README.th.md) | 🇺🇦 [Українська](README.uk-UA.md) | 🇸🇦 [العربية](README.ar.md) | 🇯🇵 [日本語](README.ja.md) | 🇻🇳 [Tiếng Việt](README.vi.md) | 🇧🇬 [Български](README.bg.md) | 🇩🇰 [Dansk](README.da.md) | 🇫🇮 [Suomi](README.fi.md) | 🇮🇱 [עברית](README.he.md) | 🇭🇺 [Magyar](README.hu.md) | 🇮🇩 [Bahasa Indonesia](README.id.md) | 🇰🇷 [한국어](README.ko.md) | 🇲🇾 [Bahasa Melayu](README.ms.md) | 🇳🇱 [Nederlands](README.nl.md) | 🇳🇴 [Norsk](README.no.md) | 🇵🇹 [Português (Portugal)](README.pt.md) | 🇷🇴 [Română](README.ro.md) | 🇵🇱 [Polski](README.pl.md) | 🇸🇰 [Slovenčina](README.sk.md) | 🇸🇪 [Svenska](README.sv.md) | 🇵🇭 [Filipino](README.phi.md)
</div>
- **Website**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
- **WhatsApp**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
- **Original Project**: [9router by decolua](https://github.com/decolua/9router)
---
@@ -321,67 +331,6 @@ When minimized, OmniRoute lives in your system tray with quick actions:
---
## 🎯 Use Cases
### Case 1: "I have Claude Pro subscription"
**Problem:** Quota expires unused, rate limits during heavy coding
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Case 2: "I want zero cost"
**Problem:** Can't afford subscriptions, need reliable AI coding
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Case 3: "I need 24/7 coding, no interruptions"
**Problem:** Deadlines, can't afford downtime
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Case 4: "I want FREE AI in OpenClaw"
**Problem:** Need AI assistant in messaging apps, completely free
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Key Features
### 🧠 Core Routing & Intelligence
@@ -542,6 +491,67 @@ OmniRoute includes a powerful built-in Translator Playground with **4 modes** fo
---
## 🎯 Use Cases
### Case 1: "I have Claude Pro subscription"
**Problem:** Quota expires unused, rate limits during heavy coding
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Case 2: "I want zero cost"
**Problem:** Can't afford subscriptions, need reliable AI coding
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Case 3: "I need 24/7 coding, no interruptions"
**Problem:** Deadlines, can't afford downtime
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Case 4: "I want FREE AI in OpenClaw"
**Problem:** Need AI assistant in messaging apps, completely free
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Setup Guide
<details>
@@ -822,74 +832,6 @@ Settings → API Configuration:
---
## 📊 Available Models
<details>
<summary><b>View all available models</b></summary>
**Claude Code (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Codex (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - FREE:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub Copilot (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - FREE credits:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- 50+ more models on [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - $0.6/1M:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - $0.2/1M:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - FREE:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - FREE:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - FREE:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100+ models:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Any model from [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Evaluations (Evals)
OmniRoute includes a built-in evaluation framework to test LLM response quality against a golden set. Access it via **Analytics → Evals** in the dashboard.
@@ -913,13 +855,67 @@ The pre-loaded "OmniRoute Golden Set" contains 10 test cases covering:
---
## 🔐 OAuth em Servidor Remoto (Remote OAuth Setup)
## 🐛 Troubleshooting
<details>
<summary><b>Click to expand troubleshooting guide</b></summary>
**"Language model did not provide messages"**
- Provider quota exhausted → Check dashboard quota tracker
- Solution: Use combo fallback or switch to cheaper tier
**Rate limiting**
- Subscription quota out → Fallback to GLM/MiniMax
- Add combo: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**OAuth token expired**
- Auto-refreshed by OmniRoute
- If issues persist: Dashboard → Provider → Reconnect
**High costs**
- Check usage stats in Dashboard → Costs
- Switch primary model to GLM/MiniMax
- Use free tier (Gemini CLI, iFlow) for non-critical tasks
**Dashboard/API ports are wrong**
- `PORT` is the canonical base port (and API port by default)
- `API_PORT` overrides only OpenAI-compatible API listener
- `DASHBOARD_PORT` overrides only dashboard/Next.js listener
- Set `NEXT_PUBLIC_BASE_URL` to your dashboard/public URL (for OAuth callbacks)
**Cloud sync errors**
- Verify `BASE_URL` points to your running instance
- Verify `CLOUD_URL` points to your expected cloud endpoint
- Keep `NEXT_PUBLIC_*` values aligned with server-side values
**First login not working**
- Check `INITIAL_PASSWORD` in `.env`
- If unset, fallback password is `123456`
**No request logs**
- Set `ENABLE_REQUEST_LOGS=true` in `.env`
**Connection test shows "Invalid" for OpenAI-compatible providers**
- Many providers don't expose a `/models` endpoint
- OmniRoute v1.0.6+ includes fallback validation via chat completions
- Ensure base URL includes `/v1` suffix
### 🔐 OAuth em Servidor Remoto (Remote OAuth Setup)
<a name="oauth-em-servidor-remoto"></a>
> **⚠️ IMPORTANTE para usuários com OmniRoute em VPS/Docker/servidor remoto**
### Por que o OAuth do Antigravity / Gemini CLI falha em servidores remotos?
#### Por que o OAuth do Antigravity / Gemini CLI falha em servidores remotos?
Os provedores **Antigravity** e **Gemini CLI** usam **Google OAuth 2.0** para autenticação. O Google exige que a `redirect_uri` usada no fluxo OAuth seja **exatamente** uma das URIs pré-cadastradas no Google Cloud Console do aplicativo.
@@ -929,7 +925,7 @@ As credenciais OAuth embutidas no OmniRoute estão cadastradas **apenas para `lo
Error 400: redirect_uri_mismatch
```
### Solução: Configure suas próprias credenciais OAuth
#### Solução: Configure suas próprias credenciais OAuth
Você precisa criar um **OAuth 2.0 Client ID** no Google Cloud Console com a URI do seu servidor.
@@ -992,7 +988,7 @@ Agora o Google redirecionará corretamente para `https://seu-servidor.com/callba
---
### Workaround temporário (sem configurar credenciais próprias)
#### Workaround temporário (sem configurar credenciais próprias)
Se não quiser criar credenciais próprias agora, ainda é possível usar o fluxo **manual de URL**:
@@ -1004,62 +1000,6 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux
> Este workaround funciona porque o código de autorização na URL é válido independente do redirect ter carregado ou não.
---
## 🐛 Troubleshooting
<details>
<summary><b>Click to expand troubleshooting guide</b></summary>
**"Language model did not provide messages"**
- Provider quota exhausted → Check dashboard quota tracker
- Solution: Use combo fallback or switch to cheaper tier
**Rate limiting**
- Subscription quota out → Fallback to GLM/MiniMax
- Add combo: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**OAuth token expired**
- Auto-refreshed by OmniRoute
- If issues persist: Dashboard → Provider → Reconnect
**High costs**
- Check usage stats in Dashboard → Costs
- Switch primary model to GLM/MiniMax
- Use free tier (Gemini CLI, iFlow) for non-critical tasks
**Dashboard/API ports are wrong**
- `PORT` is the canonical base port (and API port by default)
- `API_PORT` overrides only OpenAI-compatible API listener
- `DASHBOARD_PORT` overrides only dashboard/Next.js listener
- Set `NEXT_PUBLIC_BASE_URL` to your dashboard/public URL (for OAuth callbacks)
**Cloud sync errors**
- Verify `BASE_URL` points to your running instance
- Verify `CLOUD_URL` points to your expected cloud endpoint
- Keep `NEXT_PUBLIC_*` values aligned with server-side values
**First login not working**
- Check `INITIAL_PASSWORD` in `.env`
- If unset, fallback password is `123456`
**No request logs**
- Set `ENABLE_REQUEST_LOGS=true` in `.env`
**Connection test shows "Invalid" for OpenAI-compatible providers**
- Many providers don't expose a `/models` endpoint
- OmniRoute v1.0.6+ includes fallback validation via chat completions
- Ensure base URL includes `/v1` suffix
</details>
---
@@ -1141,18 +1081,6 @@ OmniRoute has **210+ features planned** across multiple development phases. Here
---
## 📧 Support
> 💬 **Join our community!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Get help, share tips, and stay updated.
- **Website**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
- **WhatsApp**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
- **Original Project**: [9router by decolua](https://github.com/decolua/9router)
---
## 👥 Contributors
[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=100&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
@@ -1202,85 +1130,6 @@ MIT License - see [LICENSE](LICENSE) for details.
---
---
## 🇧🇷 OmniRoute — Gateway de IA Gratuito
<a name="-omniroute--gateway-de-ia-gratuito"></a>
### Nunca pare de codar. Roteamento inteligente para **modelos de IA GRATUITOS e de baixo custo** com fallback automático.
_Seu proxy universal de API — um endpoint, 36+ provedores, zero downtime._
### 🌐 Internacionalização (i18n)
O dashboard do OmniRoute suporta **múltiplos idiomas**. Atualmente disponível em:
| Idioma | Código | Status |
| --------------------- | ------- | ----------- |
| 🇺🇸 English | `en` | ✅ Completo |
| 🇧🇷 Português (Brasil) | `pt-BR` | ✅ Completo |
**Para trocar o idioma:** Clique no seletor de idioma (🇺🇸 EN) no header do dashboard → selecione o idioma desejado.
**Para adicionar um novo idioma:**
1. Crie `src/i18n/messages/{codigo}.json` baseado em `en.json`
2. Adicione o código em `src/i18n/config.ts``LOCALES` e `LANGUAGES`
3. Reinicie o servidor
### ⚡ Início Rápido
```bash
# Instalar via npm
npx omniroute@latest
# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
```
### 🐳 Docker
```bash
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
```
### 🔑 Funcionalidades Principais
- **36+ provedores de IA** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek, e mais
- **Roteamento inteligente** — Fallback automático entre provedores
- **Tradução de formato** — OpenAI ↔ Claude ↔ Gemini automaticamente
- **Multi-conta** — Múltiplas contas por provedor com seleção inteligente
- **Cache semântico** — Reduz custos e latência
- **OAuth automático** — Tokens renovam automaticamente
- **Combos personalizados** — 6 estratégias de roteamento
- **Dashboard completo** — Monitoramento, logs, análises, configurações
- **CLI Tools** — Configure Claude Code, Codex, Cursor, Cline com um clique
- **100% TypeScript** — Código limpo e tipado
### 📖 Documentação
| Documento | Descrição |
| ----------------------------------------------- | -------------------------------------- |
| [Guia do Usuário](docs/USER_GUIDE.md) | Provedores, combos, CLI, deploy |
| [Referência da API](docs/API_REFERENCE.md) | Todos os endpoints com exemplos |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Problemas comuns e soluções |
| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura e internos do sistema |
| [Contribuição](CONTRIBUTING.md) | Setup de desenvolvimento e guidelines |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Guia completo: VM + nginx + Cloudflare |
### 📧 Suporte
> 💬 **Entre para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tire dúvidas, compartilhe dicas e fique atualizado.
- **Website**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
---
<div align="center">
<sub>Built with ❤️ for developers who code 24/7</sub>
<br/>

View File

@@ -3,8 +3,6 @@
# 🚀 OmniRoute — Gerbang AI Percuma
🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
### Jangan sekali-kali berhenti mengekod. Penghalaan pintar ke **model AI PERCUMA & kos rendah** dengan sandaran automatik.
_Proksi API universal anda — satu titik akhir, 36+ pembekal, masa henti sifar._
@@ -298,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Kes Penggunaan
### Kes 1: "Saya mempunyai langganan Claude Pro"
**Masalah:** Kuota tamat tempoh tidak digunakan, had kadar semasa pengekodan berat
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Kes 2: "Saya mahu kos sifar"
**Masalah:** Tidak mampu membayar langganan, memerlukan pengekodan AI yang boleh dipercayai
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Kes 3: "Saya memerlukan pengekodan 24/7, tiada gangguan"
**Masalah:** Tarikh akhir, tidak mampu membayar masa henti
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Kes 4: "Saya mahukan AI PERCUMA dalam OpenClaw"
**Masalah:** Memerlukan pembantu AI dalam apl pemesejan, percuma sepenuhnya
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Ciri Utama
### 🧠 Penghalaan Teras & Kepintaran
@@ -519,6 +456,67 @@ OmniRoute termasuk Taman Permainan Penterjemah terbina dalam yang berkuasa denga
---
## 🎯 Kes Penggunaan
### Kes 1: "Saya mempunyai langganan Claude Pro"
**Masalah:** Kuota tamat tempoh tidak digunakan, had kadar semasa pengekodan berat
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Kes 2: "Saya mahu kos sifar"
**Masalah:** Tidak mampu membayar langganan, memerlukan pengekodan AI yang boleh dipercayai
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Kes 3: "Saya memerlukan pengekodan 24/7, tiada gangguan"
**Masalah:** Tarikh akhir, tidak mampu membayar masa henti
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Kes 4: "Saya mahukan AI PERCUMA dalam OpenClaw"
**Masalah:** Memerlukan pembantu AI dalam apl pemesejan, percuma sepenuhnya
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Panduan Persediaan
<details>
@@ -799,74 +797,6 @@ Settings → API Configuration:
---
## 📊 Model Tersedia
<details>
<summary><b>Lihat semua model yang tersedia</b></summary>
**Kod Claude (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Codex (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - PERCUMA:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub Copilot (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - Kredit PERCUMA:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- 50+ lagi model di [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - $0.6/1J:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - $0.2/1J:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - PERCUMA:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - PERCUMA:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - PERCUMA:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100+ model:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Mana-mana model daripada [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Penilaian (Evals)
OmniRoute termasuk rangka kerja penilaian terbina dalam untuk menguji kualiti tindak balas LLM terhadap set emas. Aksesnya melalui **Analytics → Evals** dalam papan pemuka.
@@ -890,7 +820,58 @@ OmniRoute termasuk rangka kerja penilaian terbina dalam untuk menguji kualiti ti
---
## 🔐 OAuth em Servidor Remoto (Persediaan OAuth Jauh)
## 🐛 Menyelesaikan masalah
<details>
<summary><b>Klik untuk mengembangkan panduan penyelesaian masalah</b></summary>
**"Model bahasa tidak memberikan mesej"**
- Kuota pembekal habis → Semak penjejak kuota papan pemuka
- Penyelesaian: Gunakan sandaran kombo atau tukar kepada peringkat yang lebih murah
**Penghadan kadar**
- Kuota langganan habis → Sandar kepada GLM/MiniMax
- Tambah kombo: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**Token OAuth tamat tempoh**
- Dikemas semula secara automatik oleh OmniRoute
- Jika isu berterusan: Papan Pemuka → Pembekal → Sambung semula
**Kos tinggi**
- Semak statistik penggunaan dalam Papan Pemuka → Kos
- Tukar model utama kepada GLM/MiniMax
- Gunakan peringkat percuma (Gemini CLI, iFlow) untuk tugasan yang tidak kritikal
**Papan pemuka dibuka pada port yang salah**
- Tetapkan `PORT=20128` dan `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Ralat penyegerakan awan**
- Sahkan `BASE_URL` mata pada contoh larian anda
- Sahkan `CLOUD_URL` mata ke titik akhir awan anda yang dijangkakan
- Pastikan nilai `NEXT_PUBLIC_*` sejajar dengan nilai sebelah pelayan
**Log masuk pertama tidak berfungsi**
- Semak `INITIAL_PASSWORD` dalam `.env`
- Jika tidak ditetapkan, kata laluan sandaran ialah `123456`
**Tiada log permintaan**
- Tetapkan `ENABLE_REQUEST_LOGS=true` dalam `.env`
**Ujian sambungan menunjukkan "Tidak sah" untuk pembekal yang serasi dengan OpenAI**
- Banyak pembekal tidak mendedahkan titik akhir `/models`
- OmniRoute v1.0.6+ termasuk pengesahan sandaran melalui pelengkapan sembang
- Pastikan URL asas mengandungi akhiran `/v1`
### 🔐 OAuth em Servidor Remoto (Persediaan OAuth Jauh)
<a name="oauth-em-servidor-remoto"></a>
@@ -981,59 +962,6 @@ Jika anda ingin mendapatkan credenciais próprias agora, ada kemungkinan penggun
> Penyelesaian ini berfungsi sebagai kodigo de autorização na URL adalah bebas untuk mengubah hala mengikut arahan atau tidak.
---
## 🐛 Menyelesaikan masalah
<details>
<summary><b>Klik untuk mengembangkan panduan penyelesaian masalah</b></summary>
**"Model bahasa tidak memberikan mesej"**
- Kuota pembekal habis → Semak penjejak kuota papan pemuka
- Penyelesaian: Gunakan sandaran kombo atau tukar kepada peringkat yang lebih murah
**Penghadan kadar**
- Kuota langganan habis → Sandar kepada GLM/MiniMax
- Tambah kombo: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**Token OAuth tamat tempoh**
- Dikemas semula secara automatik oleh OmniRoute
- Jika isu berterusan: Papan Pemuka → Pembekal → Sambung semula
**Kos tinggi**
- Semak statistik penggunaan dalam Papan Pemuka → Kos
- Tukar model utama kepada GLM/MiniMax
- Gunakan peringkat percuma (Gemini CLI, iFlow) untuk tugasan yang tidak kritikal
**Papan pemuka dibuka pada port yang salah**
- Tetapkan `PORT=20128` dan `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Ralat penyegerakan awan**
- Sahkan `BASE_URL` mata pada contoh larian anda
- Sahkan `CLOUD_URL` mata ke titik akhir awan anda yang dijangkakan
- Pastikan nilai `NEXT_PUBLIC_*` sejajar dengan nilai sebelah pelayan
**Log masuk pertama tidak berfungsi**
- Semak `INITIAL_PASSWORD` dalam `.env`
- Jika tidak ditetapkan, kata laluan sandaran ialah `123456`
**Tiada log permintaan**
- Tetapkan `ENABLE_REQUEST_LOGS=true` dalam `.env`
**Ujian sambungan menunjukkan "Tidak sah" untuk pembekal yang serasi dengan OpenAI**
- Banyak pembekal tidak mendedahkan titik akhir `/models`
- OmniRoute v1.0.6+ termasuk pengesahan sandaran melalui pelengkapan sembang
- Pastikan URL asas mengandungi akhiran `/v1`
</details>
---
@@ -1176,85 +1104,6 @@ Lesen MIT - lihat [LICENSE](LICENSE) untuk butiran.
---
---
## 🇧🇷 OmniRoute — Gateway de IA Gratuito
<a name="-omniroute--gateway-de-ia-gratuito"></a>
### Nunca pare de codar. Roteamento intelligente para **models de IA GRATUITOS e de baixo custo** com fallback automático.
_Seu proksi universal de API — titik akhir, 36+ bukti, masa henti sifar._
### 🌐 Internacionalização (i18n)
Papan pemuka buat OmniRoute menyokong **multipplos idiomas**. Anda boleh membelinya:
| Idioma | Código | Status |
| --------------------- | ------- | ---------- |
| 🇺🇸 Bahasa Inggeris | `en` | ✅ Lengkap |
| 🇧🇷 Português (Brasil) | `pt-BR` | ✅ Lengkap |
**Para trocar o idioma:** Clique no seletor de idioma (🇺🇸 EN) no header do dashboard → selecione o idioma desejado.
**Para adicionar um novo idioma:**
1. Menangis `src/i18n/messages/{codigo}.json` baseado em `en.json`
2. Tambah código em `src/i18n/config.ts``LOCALES` e `LANGUAGES`
3. Reinicie o servidor
### ⚡ Início Rápido
```bash
# Instalar via npm
npx omniroute@latest
# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
```
### 🐳 Docker
```bash
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
```
### 🔑 Funcionalidades Principais
- **36+ bukti IA** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek, dan lain-lain
- **Roteamento intelligente** — Fallback automático entre provedores
- **Tradução de formato** — OpenAI ↔ Claude ↔ Gemini automaticamente
- **Multi-conta** — Múltiplas contas por provedor com seleção intelligente
- **Cache semântico** — Reduz custos e latência
- **OAuth automático** — Token renovam automaticamente
- **Kombo personalizados** — 6 estratégias de roteamento
- **Papan pemuka siap** — Pemantauan, log, analisis, konfigurasi
- **Alat CLI** — Konfigurasikan Kod Claude, Codex, Kursor, Cline com um clique
- **100% TypeScript** — Código limpo dan tipado
### 📖 Dokumentasi
| Dokumentasi | Penerangan |
| ----------------------------------------------- | -------------------------------------------- |
| [Guia do Usuário](docs/USER_GUIDE.md) | Provedores, gabungan, CLI, gunakan |
| [Referência da API](docs/API_REFERENCE.md) | Todos os endpoints com exemplos |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Masalah komun dan penyelesaian |
| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura dan internos do sistema |
| [Contribuição](CONTRIBUTING.md) | Persediaan desenvolvimento dan garis panduan |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Panduan lengkap: VM + nginx + Cloudflare |
### 📧 Sokongan
> 💬 **Entre for a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tire dúvidas, compartilhe dicas and fique atualizado.
- **Laman web**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Isu**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
---
<div align="center">
<sub>Dibina dengan ❤️ untuk pembangun yang kod 24/7</sub>
<br/>

View File

@@ -3,8 +3,6 @@
# 🚀 OmniRoute — De gratis AI-gateway
🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
### Stop nooit met coderen. Slimme routering naar **GRATIS en voordelige AI-modellen** met automatische terugval.
_Uw universele API-proxy: één eindpunt, meer dan 36 providers, geen downtime._
@@ -298,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Gebruiksscenario's
### Geval 1: "Ik heb een Claude Pro-abonnement"
**Probleem:** Quotum verloopt ongebruikt, snelheidslimieten tijdens intensief coderen
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Geval 2: "Ik wil geen kosten"
**Probleem:** Ik kan geen abonnementen betalen, heb betrouwbare AI-codering nodig
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Geval 3: "Ik heb 24/7 codering nodig, geen onderbrekingen"
**Probleem:** Deadlines, downtime is niet mogelijk
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Case 4: "Ik wil GRATIS AI in OpenClaw"
**Probleem:** AI-assistent nodig in berichtenapps, geheel gratis
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Belangrijkste kenmerken
### 🧠 Kernroutering en intelligentie
@@ -519,6 +456,67 @@ OmniRoute bevat een krachtige ingebouwde Translator Playground met **4 modi** vo
---
## 🎯 Gebruiksscenario's
### Geval 1: "Ik heb een Claude Pro-abonnement"
**Probleem:** Quotum verloopt ongebruikt, snelheidslimieten tijdens intensief coderen
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Geval 2: "Ik wil geen kosten"
**Probleem:** Ik kan geen abonnementen betalen, heb betrouwbare AI-codering nodig
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Geval 3: "Ik heb 24/7 codering nodig, geen onderbrekingen"
**Probleem:** Deadlines, downtime is niet mogelijk
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Case 4: "Ik wil GRATIS AI in OpenClaw"
**Probleem:** AI-assistent nodig in berichtenapps, geheel gratis
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Installatiehandleiding
<details>
@@ -799,74 +797,6 @@ Settings → API Configuration:
---
## 📊 Beschikbare modellen
<details>
<summary><b>Bekijk alle beschikbare modellen</b></summary>
**Claude-code (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Codex (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - GRATIS:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub-copiloot (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - GRATIS tegoeden:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- 50+ meer modellen op [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - $ 0,6/1 miljoen:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - $ 0,2/1 miljoen:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - GRATIS:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - GRATIS:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - GRATIS:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100+ modellen:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Elk model vanaf [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Evaluaties (Evals)
OmniRoute bevat een ingebouwd evaluatieframework om de LLM-responskwaliteit te testen aan de hand van een gouden set. U kunt deze openen via **Analytics → Evaluaties** in het dashboard.
@@ -890,7 +820,58 @@ De vooraf geladen "OmniRoute Golden Set" bevat 10 testcases die betrekking hebbe
---
## 🔐 OAuth em Servidor Remoto (OAuth-installatie op afstand)
## 🐛 Problemen oplossen
<details>
<summary><b>Klik om de probleemoplossingsgids uit te vouwen</b></summary>
**"Taalmodel heeft geen berichten verstrekt"**
- Providerquotum opgebruikt → Controleer dashboardquotumtracker
- Oplossing: gebruik combo-fallback of schakel over naar een goedkoper niveau
**Snelheidslimiet**
- Abonnementquotum op → Terugval op GLM/MiniMax
- Combinatie toevoegen: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**OAuth-token verlopen**
- Automatisch vernieuwd door OmniRoute
- Als de problemen aanhouden: Dashboard → Provider → Opnieuw verbinding maken
**Hoge kosten**
- Controleer gebruiksstatistieken in Dashboard → Kosten
- Schakel het primaire model over naar GLM/MiniMax
- Gebruik de gratis laag (Gemini CLI, iFlow) voor niet-kritieke taken
**Dashboard opent op verkeerde poort**
- Stel `PORT=20128` en `NEXT_PUBLIC_BASE_URL=http://localhost:20128` in
**Cloudsynchronisatiefouten**
- Controleer of `BASE_URL` verwijst naar uw actieve exemplaar
- Controleer of `CLOUD_URL` verwijst naar uw verwachte cloudeindpunt
- Houd `NEXT_PUBLIC_*` waarden afgestemd op de waarden op de server
**Eerste login werkt niet**
- Controleer `INITIAL_PASSWORD` in `.env`
- Indien niet ingesteld, is het reservewachtwoord `123456`
**Geen verzoeklogboeken**
- Stel `ENABLE_REQUEST_LOGS=true` in in `.env`
**Verbindingstest toont "Ongeldig" voor OpenAI-compatibele providers**
- Veel providers stellen geen `/models` eindpunt beschikbaar
- OmniRoute v1.0.6+ omvat fallback-validatie via chat-voltooiingen
- Zorg ervoor dat de basis-URL het achtervoegsel `/v1` bevat
### 🔐 OAuth em Servidor Remoto (OAuth-installatie op afstand)
<a name="oauth-em-servidor-remoto"></a>
@@ -981,59 +962,6 @@ Als u geen geloofwaardige geloofwaardigheid meer heeft, is het mogelijk om de st
> Deze tijdelijke oplossing werkt door de autorisatiecode van de URL en is onafhankelijk van het omleiden naar uw autorisatie of niet.
---
## 🐛 Problemen oplossen
<details>
<summary><b>Klik om de probleemoplossingsgids uit te vouwen</b></summary>
**"Taalmodel heeft geen berichten verstrekt"**
- Providerquotum opgebruikt → Controleer dashboardquotumtracker
- Oplossing: gebruik combo-fallback of schakel over naar een goedkoper niveau
**Snelheidslimiet**
- Abonnementquotum op → Terugval op GLM/MiniMax
- Combinatie toevoegen: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**OAuth-token verlopen**
- Automatisch vernieuwd door OmniRoute
- Als de problemen aanhouden: Dashboard → Provider → Opnieuw verbinding maken
**Hoge kosten**
- Controleer gebruiksstatistieken in Dashboard → Kosten
- Schakel het primaire model over naar GLM/MiniMax
- Gebruik de gratis laag (Gemini CLI, iFlow) voor niet-kritieke taken
**Dashboard opent op verkeerde poort**
- Stel `PORT=20128` en `NEXT_PUBLIC_BASE_URL=http://localhost:20128` in
**Cloudsynchronisatiefouten**
- Controleer of `BASE_URL` verwijst naar uw actieve exemplaar
- Controleer of `CLOUD_URL` verwijst naar uw verwachte cloudeindpunt
- Houd `NEXT_PUBLIC_*` waarden afgestemd op de waarden op de server
**Eerste login werkt niet**
- Controleer `INITIAL_PASSWORD` in `.env`
- Indien niet ingesteld, is het reservewachtwoord `123456`
**Geen verzoeklogboeken**
- Stel `ENABLE_REQUEST_LOGS=true` in in `.env`
**Verbindingstest toont "Ongeldig" voor OpenAI-compatibele providers**
- Veel providers stellen geen `/models` eindpunt beschikbaar
- OmniRoute v1.0.6+ omvat fallback-validatie via chat-voltooiingen
- Zorg ervoor dat de basis-URL het achtervoegsel `/v1` bevat
</details>
---
@@ -1176,85 +1104,6 @@ MIT-licentie - zie [LICENSE](LICENSE) voor details.
---
---
## 🇧🇷 OmniRoute — Gateway de IA Gratis
<a name="-omniroute--gateway-de-ia-gratuito"></a>
### Nunca de coder. Intelligente rotatie voor **gratis IA-modellen en klantgerichte** met automatische terugval.
_Seu proxy universal de API - een eindpunt, 36+ tests, geen downtime._
### 🌐 Internacionalização (i18n)
Het dashboard ondersteunt **meerdere uitdrukkingen** door OmniRoute. Uiteindelijk wordt dit afgewezen:
| Idioom | Código | Staat |
| ----------------------- | ------- | ----------- |
| 🇺🇸 Engels | `en` | ✅ Compleet |
| 🇧🇷 Português (Brazilië) | `pt-BR` | ✅ Compleet |
**Para trocar o idioma:** Clique no seletor de idioma (🇺🇸 EN) no header do dashboard → selectie van idioom desejado.
**Voor een nieuw idioom:**
1. Roep `src/i18n/messages/{codigo}.json` op `en.json`
2. Voeg een code toe aan `src/i18n/config.ts``LOCALES` en `LANGUAGES`
3. Reinicie of dienstverlener
### ⚡ Início Rápido
```bash
# Instalar via npm
npx omniroute@latest
# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
```
### 🐳 Docker
```bash
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
```
### 🔑Funcionalidades Principais
- **36+ IA-tests** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek, en meer
- **Roteamento inteligente** — Automatische terugval tussen de bewijzen
- **Formaattraditie** — OpenAI ↔ Claude ↔ Gemini automatisch
- **Multi-conta** — Meerdere contass door bewijs of met intelligente selectie
- **Semântico cache** — Verlaag de kosten en letaliteit
- **OAuth automático** — Tokens worden automatisch vernieuwd
- **Persoonlijke combinaties** — 6 roteamento-indelingen
- **Dashboard compleet** — Monitoren, logs, analyses, configuraties
- **CLI Tools** — Configureer Claude Code, Codex, Cursor, Cline als een kliek
- **100% TypeScript** — Code is limpo en tipado
### 📖 Documentação
| Document | Beschrijving |
| ----------------------------------------------- | ------------------------------------------- |
| [Guia do Usuário](docs/USER_GUIDE.md) | Provedores, combo's, CLI, implementeren |
| [Referência da API](docs/API_REFERENCE.md) | Alle eindpunten met voorbeelden |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Gemeenschappelijke problemen en oplossingen |
| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura en internos do system |
| [Contribuição](CONTRIBUTING.md) | Opstelling van de ontwikkelingsrichtlijnen |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Volledige versie: VM + nginx + Cloudflare |
### 📧 Steun
> 💬 **Entre para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Banden, vergelijkingen en vijf gebeurtenissen.
- **Website**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Problemen**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
---
<div align="center">
<sub>Gebouwd met ❤️ voor ontwikkelaars die 24/7 coderen</sub>
<br/>

View File

@@ -3,8 +3,6 @@
# 🚀 OmniRoute — Den gratis AI-gatewayen
🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
### Slutt aldri å kode. Smart ruting til **GRATIS og rimelige AI-modeller** med automatisk fallback.
_Din universelle API-proxy ett endepunkt, 36+ leverandører, null nedetid._
@@ -298,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Brukssaker
### Sak 1: "Jeg har Claude Pro-abonnement"
**Problem:** Kvoten utløper ubrukt, satsgrenser under tung koding
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Tilfelle 2: "Jeg vil ha null kostnad"
**Problem:** Har ikke råd til abonnementer, trenger pålitelig AI-koding
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Tilfelle 3: "Jeg trenger 24/7 koding, ingen avbrudd"
**Problem:** Tidsfrister, har ikke råd til nedetid
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Tilfelle 4: "Jeg vil ha GRATIS AI i OpenClaw"
**Problem:** Trenger AI-assistent i meldingsapper, helt gratis
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Nøkkelfunksjoner
### 🧠 Kjerneruting og intelligens
@@ -519,6 +456,67 @@ OmniRoute inkluderer en kraftig innebygd oversetterlekeplass med **4 moduser** f
---
## 🎯 Brukssaker
### Sak 1: "Jeg har Claude Pro-abonnement"
**Problem:** Kvoten utløper ubrukt, satsgrenser under tung koding
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Tilfelle 2: "Jeg vil ha null kostnad"
**Problem:** Har ikke råd til abonnementer, trenger pålitelig AI-koding
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Tilfelle 3: "Jeg trenger 24/7 koding, ingen avbrudd"
**Problem:** Tidsfrister, har ikke råd til nedetid
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Tilfelle 4: "Jeg vil ha GRATIS AI i OpenClaw"
**Problem:** Trenger AI-assistent i meldingsapper, helt gratis
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Oppsettveiledning
<details>
@@ -799,74 +797,6 @@ Settings → API Configuration:
---
## 📊 Tilgjengelige modeller
<details>
<summary><b>Se alle tilgjengelige modeller</b></summary>
**Claude-kode (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Kodex (`cx/`)** - Pluss/Proff:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - GRATIS:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub Copilot (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - GRATIS kreditter:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- 50+ flere modeller på [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - $0,6/1M:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - $0,2/1M:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - GRATIS:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - GRATIS:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - GRATIS:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100+ modeller:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Alle modeller fra [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Evalueringer (evalueringer)
OmniRoute inkluderer et innebygd evalueringsrammeverk for å teste LLM-responskvaliteten mot et gyldent sett. Få tilgang til den via **Analytics → Evals** i dashbordet.
@@ -890,7 +820,58 @@ Det forhåndsinstallerte "OmniRoute Golden Set" inneholder 10 testcases som dekk
---
## 🔐 OAuth em Servidor Remoto (Ekstern OAuth-oppsett)
## 🐛 Feilsøking
<details>
<summary><b>Klikk for å utvide feilsøkingsveiledningen</b></summary>
**«Språkmodellen ga ikke meldinger»**
- Leverandørkvoten er oppbrukt → Sjekk dashboardkvotesporing
- Løsning: Bruk kombinasjonsalternativ eller bytt til et billigere nivå
**Satsbegrensning**
- Abonnementskvote ut → Fallback til GLM/MiniMax
- Legg til kombinasjon: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**OAuth-token er utløpt**
- Automatisk oppdatering av OmniRoute
- Hvis problemene vedvarer: Dashboard → Leverandør → Koble til på nytt
**Høye kostnader**
- Sjekk bruksstatistikk i Dashboard → Kostnader
- Bytt primærmodell til GLM/MiniMax
- Bruk gratis nivå (Gemini CLI, iFlow) for ikke-kritiske oppgaver
**Dashboard åpnes på feil port**
- Sett `PORT=20128` og `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Skysynkroniseringsfeil**
- Bekreft at `BASE_URL` peker på løpeforekomsten din
- Bekreft `CLOUD_URL` poeng til det forventede skyendepunktet
- Hold `NEXT_PUBLIC_*` verdier på linje med verdiene på tjenersiden
**Første pålogging fungerer ikke**
- Sjekk `INITIAL_PASSWORD` i `.env`
- Hvis det ikke er angitt, er reservepassordet `123456`
**Ingen forespørselslogger**
- Sett `ENABLE_REQUEST_LOGS=true` i `.env`
**Test viser «Ugyldig» for OpenAI-kompatible leverandører**
- Mange leverandører avslører ikke et `/models`-endepunkt
- OmniRoute v1.0.6+ inkluderer reservevalidering via chatfullføringer
- Sørg for at basis-URL inkluderer suffikset `/v1`
### 🔐 OAuth em Servidor Remoto (Ekstern OAuth-oppsett)
<a name="oauth-em-servidor-remoto"></a>
@@ -981,59 +962,6 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux
> Este workaround funciona porque or código de autorização na URL é válido independente do redirect ter carregado or não.
---
## 🐛 Feilsøking
<details>
<summary><b>Klikk for å utvide feilsøkingsveiledningen</b></summary>
**«Språkmodellen ga ikke meldinger»**
- Leverandørkvoten er oppbrukt → Sjekk dashboardkvotesporing
- Løsning: Bruk kombinasjonsalternativ eller bytt til et billigere nivå
**Satsbegrensning**
- Abonnementskvote ut → Fallback til GLM/MiniMax
- Legg til kombinasjon: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**OAuth-token er utløpt**
- Automatisk oppdatering av OmniRoute
- Hvis problemene vedvarer: Dashboard → Leverandør → Koble til på nytt
**Høye kostnader**
- Sjekk bruksstatistikk i Dashboard → Kostnader
- Bytt primærmodell til GLM/MiniMax
- Bruk gratis nivå (Gemini CLI, iFlow) for ikke-kritiske oppgaver
**Dashboard åpnes på feil port**
- Sett `PORT=20128` og `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Skysynkroniseringsfeil**
- Bekreft at `BASE_URL` peker på løpeforekomsten din
- Bekreft `CLOUD_URL` poeng til det forventede skyendepunktet
- Hold `NEXT_PUBLIC_*` verdier på linje med verdiene på tjenersiden
**Første pålogging fungerer ikke**
- Sjekk `INITIAL_PASSWORD` i `.env`
- Hvis det ikke er angitt, er reservepassordet `123456`
**Ingen forespørselslogger**
- Sett `ENABLE_REQUEST_LOGS=true` i `.env`
**Test viser «Ugyldig» for OpenAI-kompatible leverandører**
- Mange leverandører avslører ikke et `/models`-endepunkt
- OmniRoute v1.0.6+ inkluderer reservevalidering via chatfullføringer
- Sørg for at basis-URL inkluderer suffikset `/v1`
</details>
---
@@ -1176,85 +1104,6 @@ MIT-lisens - se [LICENSE](LICENSE) for detaljer.
---
---
## 🇧🇷 OmniRoute — Gateway de IA Gratuito
<a name="-omniroute--gateway-de-ia-gratuito"></a>
### Nunca pare de codar. Roteamento inteligente for **modeller av IA GRATUITOS og de baixo custo** com reserve automático.
_Seu proxy universal de API — et endepunkt, 36+ tester, null nedetid._
### 🌐 Internacionalização (i18n)
O dashbordet for OmniRoute støtter **multiplos idiomas**. Atualmente disponível em:
| Idioma | Kode | Status |
| --------------------- | ------- | ----------- |
| 🇺🇸 Engelsk | `en` | ✅ Komplett |
| 🇧🇷 Português (Brasil) | `pt-BR` | ✅ Komplett |
**Para trocar o idioma:** Clique no selector de idioma (🇺🇸 EN) no header do dashboard → selection o idioma desejado.
**Tillegg et nytt uttrykk:**
1. Crie `src/i18n/messages/{codigo}.json` baseado em `en.json`
2. Adicione o código em `src/i18n/config.ts``LOCALES` og `LANGUAGES`
3. Reinicie o servidor
### ⚡ Início Rápido
```bash
# Instalar via npm
npx omniroute@latest
# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
```
### 🐳 Docker
```bash
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
```
### 🔑 Funcionalidades Principais
- **36+ provedores de IA** - Claude, GPT, Gemini, Llama, Qwen, DeepSeek, e mais
- **Roteamento inteligente** — Fallback automático entre provedores
- **Tradução de formato** — OpenAI ↔ Claude ↔ Gemini automaticamente
- **Multi-conta** — Multiplas-innhold for testing com seleção inteligente
- **Cache semântico** — Reduz custos e latência
- **OAuth automático** — Tokens renovam automaticamente
- **Personlig kombinasjoner** — 6 estratégias de roteamento
- **Dashboard komplett** — Monitoramento, logger, analyser, konfigurasjoner
- **CLI Tools** — Konfigurer Claude Code, Codex, Cursor, Cline com um clique
- **100 % TypeScript** — Código limpo e tipado
### 📖 Dokumentasjon
| Documento | Beskrivelse |
| ----------------------------------------------- | -------------------------------------------- |
| [Guia do Usuário](docs/USER_GUIDE.md) | Provedores, combos, CLI, distribuere |
| [Referência da API](docs/API_REFERENCE.md) | Todos os endepunkter med eksempler |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Problemas comuns e soluções |
| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura e internos do sistema |
| [Contribuição](CONTRIBUTING.md) | Oppsett av desenvolvimento og retningslinjer |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Fullfør: VM + nginx + Cloudflare |
### 📧 Støtte
> 💬 **Entre para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tire dúvidas, compartilhe dicas e fique atualizado.
- **Nettsted**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Problemer**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
---
<div align="center">
<sub>Bygget med ❤️ for utviklere som koder 24/7</sub>
<br/>

View File

@@ -3,8 +3,6 @@
# 🚀 OmniRoute — Ang Libreng AI Gateway
🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
### Huwag kailanman ihinto ang coding. Smart routing sa **LIBRE at murang mga modelo ng AI** na may awtomatikong fallback.
_Iyong unibersal na API proxy — isang endpoint, 36+ provider, zero downtime._
@@ -298,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Use Cases
### Case 1: "May subscription ako sa Claude Pro"
**Problema:** Nag-e-expire ang quota nang hindi nagamit, mga limitasyon sa rate sa panahon ng mabigat na coding
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Case 2: "Gusto ko ng zero cost"
**Problema:** Hindi kayang bayaran ang mga subscription, kailangan ng maaasahang AI coding
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Case 3: "Kailangan ko ng 24/7 coding, walang mga pagkaantala"
**Problema:** Mga deadline, hindi kayang bayaran ang downtime
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Kaso 4: "Gusto ko ng LIBRENG AI sa OpenClaw"
**Problema:** Kailangan ng AI assistant sa mga app sa pagmemensahe, ganap na libre
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Mga Pangunahing Tampok
### 🧠 Core Routing at Intelligence
@@ -519,6 +456,67 @@ Kasama sa OmniRoute ang isang malakas na built-in na Playground ng Translator na
---
## 🎯 Use Cases
### Case 1: "May subscription ako sa Claude Pro"
**Problema:** Nag-e-expire ang quota nang hindi nagamit, mga limitasyon sa rate sa panahon ng mabigat na coding
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Case 2: "Gusto ko ng zero cost"
**Problema:** Hindi kayang bayaran ang mga subscription, kailangan ng maaasahang AI coding
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Case 3: "Kailangan ko ng 24/7 coding, walang mga pagkaantala"
**Problema:** Mga deadline, hindi kayang bayaran ang downtime
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Kaso 4: "Gusto ko ng LIBRENG AI sa OpenClaw"
**Problema:** Kailangan ng AI assistant sa mga app sa pagmemensahe, ganap na libre
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Gabay sa Pag-setup
<details>
@@ -799,74 +797,6 @@ Settings → API Configuration:
---
## 📊 Mga Magagamit na Modelo
<details>
<summary><b>Tingnan ang lahat ng available na modelo</b></summary>
**Claude Code (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Codex (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - LIBRE:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub Copilot (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - LIBRENG mga kredito:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- 50+ pang mga modelo sa [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - $0.6/1M:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - $0.2/1M:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - LIBRE:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - LIBRE:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - LIBRE:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100+ na modelo:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Anumang modelo mula sa [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Mga Pagsusuri (Evals)
Ang OmniRoute ay may kasamang built-in na balangkas ng pagsusuri upang subukan ang kalidad ng pagtugon ng LLM laban sa isang ginintuang hanay. I-access ito sa pamamagitan ng **Analytics → Evals** sa dashboard.
@@ -890,7 +820,58 @@ Ang pre-loaded na "OmniRoute Golden Set" ay naglalaman ng 10 test case na sumasa
---
## 🔐 OAuth em Servidor Remoto (Remote OAuth Setup)
## 🐛 Pag-troubleshoot
<details>
<summary><b>Mag-click upang palawakin ang gabay sa pag-troubleshoot</b></summary>
**"Ang modelo ng wika ay hindi nagbigay ng mga mensahe"**
- Naubos na ang quota ng provider → Suriin ang tracker ng quota ng dashboard
- Solusyon: Gumamit ng combo fallback o lumipat sa mas murang tier
**Paglilimita sa rate**
- Out na ang quota ng subscription → Fallback sa GLM/MiniMax
- Magdagdag ng combo: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**Nag-expire ang token ng OAuth**
- Auto-refresh ng OmniRoute
- Kung magpapatuloy ang mga isyu: Dashboard → Provider → Muling kumonekta
**Mataas na gastos**
- Suriin ang mga istatistika ng paggamit sa Dashboard → Mga Gastos
- Ilipat ang pangunahing modelo sa GLM/MiniMax
- Gumamit ng libreng tier (Gemini CLI, iFlow) para sa mga hindi kritikal na gawain
**Nagbubukas ang dashboard sa maling port**
- Itakda ang `PORT=20128` at `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Mga error sa cloud sync**
- I-verify ang `BASE_URL` na mga puntos sa iyong running instance
- I-verify ang `CLOUD_URL` na mga puntos sa iyong inaasahang cloud endpoint
- Panatilihing nakahanay ang mga value ng `NEXT_PUBLIC_*` sa mga value sa gilid ng server
**Hindi gumagana ang unang pag-login**
- Suriin ang `INITIAL_PASSWORD` sa `.env`
- Kung hindi nakatakda, ang fallback na password ay `123456`
**Walang mga log ng kahilingan**
- Itakda ang `ENABLE_REQUEST_LOGS=true` sa `.env`
**Ang pagsubok sa koneksyon ay nagpapakita ng "Di-wasto" para sa mga provider na katugma sa OpenAI**
- Maraming provider ang hindi naglalantad ng `/models` endpoint
- Kasama sa OmniRoute v1.0.6+ ang fallback validation sa pamamagitan ng mga pagkumpleto ng chat
- Tiyaking may kasamang `/v1` suffix ang base URL
### 🔐 OAuth em Servidor Remoto (Remote OAuth Setup)
<a name="oauth-em-servidor-remoto"></a>
@@ -969,7 +950,7 @@ Agora o Google redirectionará corretamente para sa `https://seu-servidor.com/ca
---
### Workaround temporário (sem configurar credenciais próprias)
#### Workaround temporário (sem configurar credenciais próprias)
Se não quiser criar credenciais próprias agora, may posibilidad na magamit o fluxo **manual de URL**:
@@ -981,59 +962,6 @@ Se não quiser criar credenciais próprias agora, may posibilidad na magamit o f
> Ang workaround na ito ay gumagana sa pamamagitan ng código de authorização na URL ay maaaring mag-redirect sa iyong carregado ou não.
---
## 🐛 Pag-troubleshoot
<details>
<summary><b>Mag-click upang palawakin ang gabay sa pag-troubleshoot</b></summary>
**"Ang modelo ng wika ay hindi nagbigay ng mga mensahe"**
- Naubos na ang quota ng provider → Suriin ang tracker ng quota ng dashboard
- Solusyon: Gumamit ng combo fallback o lumipat sa mas murang tier
**Paglilimita sa rate**
- Out na ang quota ng subscription → Fallback sa GLM/MiniMax
- Magdagdag ng combo: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**Nag-expire ang token ng OAuth**
- Auto-refresh ng OmniRoute
- Kung magpapatuloy ang mga isyu: Dashboard → Provider → Muling kumonekta
**Mataas na gastos**
- Suriin ang mga istatistika ng paggamit sa Dashboard → Mga Gastos
- Ilipat ang pangunahing modelo sa GLM/MiniMax
- Gumamit ng libreng tier (Gemini CLI, iFlow) para sa mga hindi kritikal na gawain
**Nagbubukas ang dashboard sa maling port**
- Itakda ang `PORT=20128` at `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Mga error sa cloud sync**
- I-verify ang `BASE_URL` na mga puntos sa iyong running instance
- I-verify ang `CLOUD_URL` na mga puntos sa iyong inaasahang cloud endpoint
- Panatilihing nakahanay ang mga value ng `NEXT_PUBLIC_*` sa mga value sa gilid ng server
**Hindi gumagana ang unang pag-login**
- Suriin ang `INITIAL_PASSWORD` sa `.env`
- Kung hindi nakatakda, ang fallback na password ay `123456`
**Walang mga log ng kahilingan**
- Itakda ang `ENABLE_REQUEST_LOGS=true` sa `.env`
**Ang pagsubok sa koneksyon ay nagpapakita ng "Di-wasto" para sa mga provider na katugma sa OpenAI**
- Maraming provider ang hindi naglalantad ng `/models` endpoint
- Kasama sa OmniRoute v1.0.6+ ang fallback validation sa pamamagitan ng mga pagkumpleto ng chat
- Tiyaking may kasamang `/v1` suffix ang base URL
</details>
---
@@ -1176,85 +1104,6 @@ Lisensya ng MIT - tingnan ang [LICENSE](LICENSE) para sa mga detalye.
---
---
## 🇧🇷 OmniRoute — Gateway de IA Gratuito
<a name="-omniroute--gateway-de-ia-gratuito"></a>
### Nunca pare de codar. Roteamento intelligente para **modelos de IA GRATUITOS e de baixo custo** com fallback automático.
_Seu proxy universal de API — um endpoint, 36+ provedores, zero downtime._
### 🌐 Internacionalização (i18n)
O dashboard ng OmniRoute suporta **multiplos idiomas**. Ibigay ang mga ito:
| Idyoma | Código | Katayuan |
| --------------------- | ------- | ----------- |
| 🇺🇸 Ingles | `en` | ✅ Kumpleto |
| 🇧🇷 Português (Brasil) | `pt-BR` | ✅ Kumpleto |
**Para trocar o idioma:** Clique no seletor de idioma (🇺🇸 EN) walang header do dashboard → selecione o idioma desejado.
**Para adicionar um novo idioma:**
1. Sumigaw `src/i18n/messages/{codigo}.json` baseado em `en.json`
2. Addicione o código em `src/i18n/config.ts``LOCALES` e `LANGUAGES`
3. Reinicie o servidor
### ⚡ Início Rápido
```bash
# Instalar via npm
npx omniroute@latest
# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
```
### 🐳 Docker
```bash
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
```
### 🔑 Funcionalidades Principais
- **36+ provedores de IA** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek, at iba pa
- **Roteamento intelligente** — Fallback automatico entre provedores
- **Tradução de formato** — OpenAI ↔ Claude ↔ Gemini automaticamente
- **Multi-conta** — Múltiplas contas por provedor com seleção intelligente
- **Cache semântico** — Reduz custos at latência
- **OAuth automático** — Token renovam automaticamente
- **Combos personalizados** — 6 estratégias de roteamento
- **Dashboard completo** — Monitoramento, logs, análises, configurações
- **CLI Tools** — I-configure ang Claude Code, Codex, Cursor, Cline com um clique
- **100% TypeScript** — Código limpo at tipado
### 📖 Documentação
| Dokumento | Paglalarawan |
| ----------------------------------------------- | ------------------------------------------- |
| [Guia do Usuário](docs/USER_GUIDE.md) | Provedores, combos, CLI, deploy |
| [Referência da API](docs/API_REFERENCE.md) | Todos os endpoints com exemplos |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Problema communs at soluções |
| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura at internos do sistema |
| [Contribuição](CONTRIBUTING.md) | Setup ng desenvolvimento at mga alituntunin |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Guia completo: VM + nginx + Cloudflare |
### 📧 Suporta
> 💬 **Entre para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tire dúvidas, compartilhe dicas e fique atualizado.
- **Website**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Mga Isyu**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
---
<div align="center">
<sub>Built with ❤️ para sa mga developer na nagko-code 24/7</sub>
<br/>

View File

@@ -3,8 +3,6 @@
# 🚀 OmniRoute — darmowa bramka AI
🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
### Nigdy nie przestawaj kodować. Inteligentne przekierowywanie do **BEZPŁATNYCH i tanich modeli AI** z automatycznym powrotem.
_Twój uniwersalny serwer proxy API — jeden punkt końcowy, ponad 36 dostawców, zero przestojów._
@@ -298,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Przypadki użycia
### Przypadek 1: „Mam subskrypcję Claude Pro”
**Problem:** Limit wygasa niewykorzystany, limity szybkości podczas intensywnego kodowania
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Przypadek 2: „Chcę zerowych kosztów”
**Problem:** Nie stać Cię na subskrypcje, potrzebujesz niezawodnego kodowania AI
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Przypadek 3: „Potrzebuję kodowania 24 godziny na dobę, 7 dni w tygodniu, bez przerw”
**Problem:** Terminy, nie mogę sobie pozwolić na przestoje
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Przypadek 4: „Chcę DARMOWEJ sztucznej inteligencji w OpenClaw”
**Problem:** Potrzebujesz asystenta AI w aplikacjach do przesyłania wiadomości, całkowicie za darmo
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Kluczowe funkcje
### 🧠 Routing i inteligencja rdzenia
@@ -519,6 +456,67 @@ OmniRoute zawiera potężny, wbudowany plac zabaw dla tłumaczy z **4 trybami**
---
## 🎯 Przypadki użycia
### Przypadek 1: „Mam subskrypcję Claude Pro”
**Problem:** Limit wygasa niewykorzystany, limity szybkości podczas intensywnego kodowania
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Przypadek 2: „Chcę zerowych kosztów”
**Problem:** Nie stać Cię na subskrypcje, potrzebujesz niezawodnego kodowania AI
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Przypadek 3: „Potrzebuję kodowania 24 godziny na dobę, 7 dni w tygodniu, bez przerw”
**Problem:** Terminy, nie mogę sobie pozwolić na przestoje
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Przypadek 4: „Chcę DARMOWEJ sztucznej inteligencji w OpenClaw”
**Problem:** Potrzebujesz asystenta AI w aplikacjach do przesyłania wiadomości, całkowicie za darmo
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Przewodnik konfiguracji
<details>
@@ -799,74 +797,6 @@ Settings → API Configuration:
---
## 📊 Dostępne modele
<details>
<summary><b>Wyświetl wszystkie dostępne modele</b></summary>
**Kod Claude (`cc/`)** Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Kodeks (`cx/`)** Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** BEZPŁATNIE:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**Drugi pilot GitHuba (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - DARMOWE kredyty:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- Ponad 50 więcej modeli na [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** 0,6 USD/1 mln:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** 0,2/1 mln USD:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - BEZPŁATNIE:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - ZA DARMO:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - ZA DARMO:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** ponad 100 modeli:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Dowolny model od [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Oceny (Ewaluacje)
OmniRoute zawiera wbudowaną platformę ewaluacyjną do testowania jakości odpowiedzi LLM na podstawie złotego zestawu. Uzyskaj do niego dostęp poprzez **Analytics → Evals** na pulpicie nawigacyjnym.
@@ -890,13 +820,64 @@ Fabrycznie załadowany „Złoty zestaw OmniRoute” zawiera 10 przypadków test
---
## 🔐 OAuth na serwerze zdalnym (zdalna konfiguracja OAuth)
## 🐛 Rozwiązywanie problemów
<details>
<summary><b>Kliknij, aby rozwinąć przewodnik rozwiązywania problemów</b></summary>
**„Model językowy nie dostarczał komunikatów”**
- Wyczerpany limit dostawcy → Sprawdź moduł śledzenia limitów na pulpicie nawigacyjnym
- Rozwiązanie: użyj kombinacji zastępczej lub przejdź na tańszy poziom
**Ograniczenie szybkości**
- Limit subskrypcji wyczerpany → Powrót do GLM/MiniMax
- Dodaj kombinację: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**Token OAuth wygasł**
- Automatyczne odświeżanie przez OmniRoute
- Jeśli problemy nadal występują: Panel kontrolny → Dostawca → Połącz ponownie
**Wysokie koszty**
- Sprawdź statystyki użytkowania w Panelu → Koszty
- Zmień model podstawowy na GLM/MiniMax
- Korzystaj z bezpłatnej warstwy (Gemini CLI, iFlow) do zadań niekrytycznych
** Panel otwiera się na złym porcie **
- Ustaw `PORT=20128` i `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Błędy synchronizacji z chmurą**
- Sprawdź, czy `BASE_URL` wskazuje na działającą instancję
- Sprawdź, czy `CLOUD_URL` wskazuje na oczekiwany punkt końcowy w chmurze
- Zachowaj wyrównanie wartości `NEXT_PUBLIC_*` z wartościami po stronie serwera
**Pierwsze logowanie nie działa**
- Sprawdź `INITIAL_PASSWORD` w `.env`
- Jeśli nieustawione, hasło zastępcze to `123456`
**Brak dzienników żądań**
- Ustaw `ENABLE_REQUEST_LOGS=true` w `.env`
**Test połączenia pokazuje „Nieprawidłowy” dla dostawców kompatybilnych z OpenAI**
- Wielu dostawców nie udostępnia punktu końcowego `/models`
- OmniRoute v1.0.6+ zawiera weryfikację awaryjną poprzez uzupełnianie czatu
- Upewnij się, że podstawowy adres URL zawiera przyrostek `/v1`
### 🔐 OAuth na serwerze zdalnym (zdalna konfiguracja OAuth)
<a name="oauth-em-servidor-remoto"></a>
> **⚠️ WAŻNE dla zwykłych usług OmniRoute w VPS/Docker/serwidor zdalny**
### Por que o OAuth do Antigravity / Gemini CLI falha na zdalnych serwerach?
#### Por que o OAuth do Antigravity / Gemini CLI falha na zdalnych serwerach?
Sprawdzone **Antigravity** i **Gemini CLI** używane **Google OAuth 2.0** dla autentyczności. O Google, jeśli potrzebujesz `redirect_uri`, aby nie zmieniać protokołu OAuth seja **exatamente** uma das URI pre-cadastradas no Google Cloud Console to aplicativo.
@@ -981,59 +962,6 @@ Jeśli chcesz uzyskać dostęp do **podręcznika URL**:
> To obejście funkcji porque o kodigo de autorização na URL é válido niezależny do przekierowania ter carregado ou não.
---
## 🐛 Rozwiązywanie problemów
<details>
<summary><b>Kliknij, aby rozwinąć przewodnik rozwiązywania problemów</b></summary>
**„Model językowy nie dostarczał komunikatów”**
- Wyczerpany limit dostawcy → Sprawdź moduł śledzenia limitów na pulpicie nawigacyjnym
- Rozwiązanie: użyj kombinacji zastępczej lub przejdź na tańszy poziom
**Ograniczenie szybkości**
- Limit subskrypcji wyczerpany → Powrót do GLM/MiniMax
- Dodaj kombinację: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**Token OAuth wygasł**
- Automatyczne odświeżanie przez OmniRoute
- Jeśli problemy nadal występują: Panel kontrolny → Dostawca → Połącz ponownie
**Wysokie koszty**
- Sprawdź statystyki użytkowania w Panelu → Koszty
- Zmień model podstawowy na GLM/MiniMax
- Korzystaj z bezpłatnej warstwy (Gemini CLI, iFlow) do zadań niekrytycznych
** Panel otwiera się na złym porcie **
- Ustaw `PORT=20128` i `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Błędy synchronizacji z chmurą**
- Sprawdź, czy `BASE_URL` wskazuje na działającą instancję
- Sprawdź, czy `CLOUD_URL` wskazuje na oczekiwany punkt końcowy w chmurze
- Zachowaj wyrównanie wartości `NEXT_PUBLIC_*` z wartościami po stronie serwera
**Pierwsze logowanie nie działa**
- Sprawdź `INITIAL_PASSWORD` w `.env`
- Jeśli nieustawione, hasło zastępcze to `123456`
**Brak dzienników żądań**
- Ustaw `ENABLE_REQUEST_LOGS=true` w `.env`
**Test połączenia pokazuje „Nieprawidłowy” dla dostawców kompatybilnych z OpenAI**
- Wielu dostawców nie udostępnia punktu końcowego `/models`
- OmniRoute v1.0.6+ zawiera weryfikację awaryjną poprzez uzupełnianie czatu
- Upewnij się, że podstawowy adres URL zawiera przyrostek `/v1`
</details>
---
@@ -1176,85 +1104,6 @@ Licencja MIT — szczegółowe informacje można znaleźć w [LICENSE](LICENSE).
---
---
## 🇧🇷 OmniRoute — bezpłatna bramka IA
<a name="-omniroute--gateway-de-ia-gratuito"></a>
### Nunca pare de codar. Roteamento inteligentne dla **modelos de IA GRATUITOS e de baixo custo** com fallback automático.
_Seu proxy universal de API — punkt końcowy, ponad 36 testów, zero przestojów._
### 🌐 Międzynarodowa analiza (i18n)
Panel obsługi OmniRoute obsługuje **wiele idiomów**. Atualmente disponível je:
| Idioma | Kodigo | Stan |
| ----------------------- | ------- | ------------ |
| 🇺🇸 angielski | `en` | ✅ Kompletne |
| 🇧🇷 Português (Brazylia) | `pt-BR` | ✅ Kompletne |
**Para trocar o idioma:** Kliknij przycisk no seletor de idioma (🇺🇸 EN) no header to dashboard → wybierz idioma desejado.
**Dosłowny nowy idiom:**
1. Płacz `src/i18n/messages/{codigo}.json` baseado em `en.json`
2. Adicione o kodigo em `src/i18n/config.ts``LOCALES` i `LANGUAGES`
3. Reinicie lub serwer
### ⚡ Início Rápido
```bash
# Instalar via npm
npx omniroute@latest
# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
```
### 🐳 Doker
```bash
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
```
### 🔑 Funcionalidades Principais
- **36+ dowodów IA** — Claude, GPT, Gemini, Lama, Qwen, DeepSeek i e-mail
- **Roteamento inteligente** — Automatyczna awaria entre Providores
- **Przetłumaczenie formatu** — OpenAI ↔ Claude ↔ Gemini automatyczne
- **Multi-conta** — Múltiplas contas por proofor com seleção inteligente
- **Cache semantico** — Reduz custos e latência
- **Automatyczne OAuth** — Automatyczne odnawianie tokenów
- **Combos personalizados** — 6 estratégias de roteamento
- **Kompletny pulpit nawigacyjny** — Monitorowanie, logi, analizy, konfiguracje
- **Narzędzia CLI** — Skonfiguruj kod Claude, Kodeks, Kursor, Cline com um clique
- **100% TypeScript** — Kodigo limpo e tipado
### 📖 Dokumentacja
| Dokument | Opis |
| ----------------------------------------------- | ----------------------------------------------------------- |
| [Guia do Usuário](docs/USER_GUIDE.md) | Provedores, kombinacje, CLI, wdrażanie |
| [Referência da API](docs/API_REFERENCE.md) | Wszystkie punkty końcowe systemu operacyjnego z przykładami |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Problemas comuns e soluções |
| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura e internos do systemu |
| [Contribuição](CONTRIBUTING.md) | Konfiguracja desenvolvimento e wytyczne |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Kompletna instrukcja: VM + nginx + Cloudflare |
### 📧 Wsparcie
> 💬 **Enter para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tyre duvidas, compartilhe dicas e fique atualizado.
- **Strona internetowa**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Problemy**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
---
<div align="center">
<sub>Zbudowany z ❤️ dla programistów, którzy kodują 24 godziny na dobę, 7 dni w tygodniu</sub>
<br/>

View File

@@ -311,67 +311,6 @@ Quando minimizado, o OmniRoute fica na bandeja do sistema com ações rápidas:
---
## 🎯 Casos de Uso
### Caso 1: "Tenho assinatura Claude Pro"
**Problema:** Cota expira sem uso, limites de taxa durante programação intensa
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (usar assinatura ao máximo)
2. glm/glm-4.7 (backup barato quando a cota acabar)
3. if/kimi-k2-thinking (fallback de emergência gratuito)
Custo mensal: $20 (assinatura) + ~$5 (backup) = $25 total
vs. $20 + bater em limites = frustração
```
### Caso 2: "Quero custo zero"
**Problema:** Não pode pagar assinaturas, precisa de IA confiável para programar
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K grátis/mês)
2. if/kimi-k2-thinking (ilimitado grátis)
3. qw/qwen3-coder-plus (ilimitado grátis)
Custo mensal: $0
Qualidade: Modelos prontos para produção
```
### Caso 3: "Preciso programar 24/7, sem interrupções"
**Problema:** Prazos apertados, não pode ter tempo de inatividade
```
Combo: "always-on"
1. cc/claude-opus-4-6 (melhor qualidade)
2. cx/gpt-5.2-codex (segunda assinatura)
3. glm/glm-4.7 (barato, reset diário)
4. minimax/MiniMax-M2.1 (mais barato, reset 5h)
5. if/kimi-k2-thinking (gratuito ilimitado)
Resultado: 5 camadas de fallback = zero tempo de inatividade
```
### Caso 4: "Quero IA GRATUITA no OpenClaw"
**Problema:** Precisa de assistente de IA em aplicativos de mensagens, completamente gratuito
```
Combo: "openclaw-free"
1. if/glm-4.7 (ilimitado grátis)
2. if/minimax-m2.1 (ilimitado grátis)
3. if/kimi-k2-thinking (ilimitado grátis)
Custo mensal: $0
Acesso via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Funcionalidades Principais
### 🧠 Roteamento e Inteligência
@@ -526,6 +465,67 @@ O OmniRoute inclui um poderoso Playground de Tradução integrado com **4 modos*
---
## 🎯 Casos de Uso
### Caso 1: "Tenho assinatura Claude Pro"
**Problema:** Cota expira sem uso, limites de taxa durante programação intensa
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (usar assinatura ao máximo)
2. glm/glm-4.7 (backup barato quando a cota acabar)
3. if/kimi-k2-thinking (fallback de emergência gratuito)
Custo mensal: $20 (assinatura) + ~$5 (backup) = $25 total
vs. $20 + bater em limites = frustração
```
### Caso 2: "Quero custo zero"
**Problema:** Não pode pagar assinaturas, precisa de IA confiável para programar
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K grátis/mês)
2. if/kimi-k2-thinking (ilimitado grátis)
3. qw/qwen3-coder-plus (ilimitado grátis)
Custo mensal: $0
Qualidade: Modelos prontos para produção
```
### Caso 3: "Preciso programar 24/7, sem interrupções"
**Problema:** Prazos apertados, não pode ter tempo de inatividade
```
Combo: "always-on"
1. cc/claude-opus-4-6 (melhor qualidade)
2. cx/gpt-5.2-codex (segunda assinatura)
3. glm/glm-4.7 (barato, reset diário)
4. minimax/MiniMax-M2.1 (mais barato, reset 5h)
5. if/kimi-k2-thinking (gratuito ilimitado)
Resultado: 5 camadas de fallback = zero tempo de inatividade
```
### Caso 4: "Quero IA GRATUITA no OpenClaw"
**Problema:** Precisa de assistente de IA em aplicativos de mensagens, completamente gratuito
```
Combo: "openclaw-free"
1. if/glm-4.7 (ilimitado grátis)
2. if/minimax-m2.1 (ilimitado grátis)
3. if/kimi-k2-thinking (ilimitado grátis)
Custo mensal: $0
Acesso via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Guia de Configuração
<details>
@@ -806,74 +806,6 @@ Configurações → Configuração de API:
---
## 📊 Modelos Disponíveis
<details>
<summary><b>Ver todos os modelos disponíveis</b></summary>
**Claude Code (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Codex (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - GRATUITO:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub Copilot (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - Créditos GRATUITOS:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- 50+ mais modelos em [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - $0.6/1M:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - $0.2/1M:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - GRATUITO:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - GRATUITO:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - GRATUITO:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100+ modelos:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Qualquer modelo de [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Avaliações (Evals)
OmniRoute inclui um framework de avaliação integrado para testar a qualidade de respostas de LLM contra um conjunto golden. Acesse via **Analytics → Evals** no dashboard.

View File

@@ -3,8 +3,6 @@
# 🚀 OmniRoute — O gateway de IA gratuito
🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
### Nunca pare de codificar. Roteamento inteligente para **modelos de IA GRATUITOS e de baixo custo** com fallback automático.
_Seu proxy de API universal — um endpoint, mais de 36 provedores, tempo de inatividade zero._
@@ -298,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Casos de uso
### Caso 1: "Tenho assinatura do Claude Pro"
**Problema:** A cota expira sem ser utilizada, limites de taxa durante codificação pesada
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Caso 2: "Quero custo zero"
**Problema:** Não posso pagar assinaturas, preciso de codificação de IA confiável
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Caso 3: "Preciso de codificação 24 horas por dia, 7 dias por semana, sem interrupções"
**Problema:** Prazos, não podemos arcar com o tempo de inatividade
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Caso 4: "Quero IA GRATUITA no OpenClaw"
**Problema:** Precisa de assistente de IA em aplicativos de mensagens, totalmente gratuito
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Principais recursos
### 🧠 Roteamento e inteligência central
@@ -519,6 +456,67 @@ OmniRoute inclui um poderoso Translator Playground integrado com **4 modos** par
---
## 🎯 Casos de uso
### Caso 1: "Tenho assinatura do Claude Pro"
**Problema:** A cota expira sem ser utilizada, limites de taxa durante codificação pesada
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Caso 2: "Quero custo zero"
**Problema:** Não posso pagar assinaturas, preciso de codificação de IA confiável
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Caso 3: "Preciso de codificação 24 horas por dia, 7 dias por semana, sem interrupções"
**Problema:** Prazos, não podemos arcar com o tempo de inatividade
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Caso 4: "Quero IA GRATUITA no OpenClaw"
**Problema:** Precisa de assistente de IA em aplicativos de mensagens, totalmente gratuito
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Guia de configuração
<details>
@@ -799,74 +797,6 @@ Settings → API Configuration:
---
## 📊 Modelos Disponíveis
<details>
<summary><b>Ver todos os modelos disponíveis</b></summary>
**Código Claude (`cc/`)** - Pro/Máx:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Códice (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - GRATUITO:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**Copiloto do GitHub (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - Créditos GRATUITOS:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- Mais de 50 modelos em [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - US$ 0,6/1 milhão:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - US$ 0,2/1 milhão:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - GRATUITO:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - GRATUITO:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - GRATUITO:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - mais de 100 modelos:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Qualquer modelo de [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Avaliações (Evals)
OmniRoute inclui uma estrutura de avaliação integrada para testar a qualidade da resposta do LLM em relação a um conjunto dourado. Acesse-o em **Analytics → Evals** no painel.
@@ -890,13 +820,64 @@ O "OmniRoute Golden Set" pré-carregado contém 10 casos de teste cobrindo:
---
## 🔐 OAuth em Servidor Remoto (Remote OAuth Setup)
## 🐛 Solução de problemas
<details>
<summary><b>Clique para expandir o guia de solução de problemas</b></summary>
**"O modelo de linguagem não forneceu mensagens"**
- Cota do provedor esgotada → Verifique o rastreador de cota do painel
- Solução: use o combo substituto ou mude para um nível mais barato
** Limitação de taxa **
- Cota de assinatura esgotada → Fallback para GLM/MiniMax
- Adicionar combinação: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**O token OAuth expirou**
- Atualizado automaticamente pelo OmniRoute
- Se os problemas persistirem: Painel → Provedor → Reconectar
**Custos elevados**
- Verifique as estatísticas de uso em Painel → Custos
- Mude o modelo primário para GLM/MiniMax
- Use o nível gratuito (Gemini CLI, iFlow) para tarefas não críticas
**Painel abre na porta errada**
- Definir `PORT=20128` e `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Erros de sincronização na nuvem**
- Verifique `BASE_URL` aponta para sua instância em execução
- Verifique os pontos `CLOUD_URL` para o endpoint de nuvem esperado
- Mantenha os valores `NEXT_PUBLIC_*` alinhados com os valores do lado do servidor
**Primeiro login não funciona**
- Verifique `INITIAL_PASSWORD` em `.env`
- Se não definida, a senha substituta é `123456`
**Sem registros de solicitação**
- Definir `ENABLE_REQUEST_LOGS=true` em `.env`
**O teste de conexão mostra "Inválido" para provedores compatíveis com OpenAI**
- Muitos provedores não expõem um endpoint `/models`
- OmniRoute v1.0.6+ inclui validação de fallback por meio de conclusões de chat
- Certifique-se de que o URL base inclua o sufixo `/v1`
### 🔐 OAuth em Servidor Remoto (Remote OAuth Setup)
<a name="oauth-em-servidor-remoto"></a>
> **⚠️ IMPORTANTE para usuários com OmniRoute em VPS/Docker/servidor remoto**
### Por que o OAuth do Antigravity / Gemini CLI falha em servidores remotos?
#### Por que o OAuth do Antigravity / Gemini CLI falha em servidores remotos?
Os provedores **Antigravity** e **Gemini CLI** usam **Google OAuth 2.0** para autenticação. O Google exige que um `redirect_uri` usado no fluxo OAuth seja **exatamente** uma das URIs pré-cadastradas no Google Cloud Console do aplicativo.
@@ -906,7 +887,7 @@ As credenciais OAuth incorporadas no OmniRoute estão cadastradas **apenas para
Error 400: redirect_uri_mismatch
```
### Solução: Configure suas próprias credenciais OAuth
#### Solução: Configure suas próprias credenciais OAuth
Você precisa criar um **OAuth 2.0 Client ID** no Google Cloud Console com o URI do seu servidor.
@@ -969,7 +950,7 @@ Agora o Google redirecionará corretamente para `https://seu-servidor.com/callba
---
### Solução alternativa temporária (sem configurar credenciais próprias)
#### Solução alternativa temporária (sem configurar credenciais próprias)
Se não quiser criar credenciais próprias agora, ainda é possível usar o fluxo **manual de URL**:
@@ -981,59 +962,6 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux
> Esta solução alternativa funciona porque o código de autorização na URL é válido, independentemente do redirecionamento ter sido carregado ou não.
---
## 🐛 Solução de problemas
<details>
<summary><b>Clique para expandir o guia de solução de problemas</b></summary>
**"O modelo de linguagem não forneceu mensagens"**
- Cota do provedor esgotada → Verifique o rastreador de cota do painel
- Solução: use o combo substituto ou mude para um nível mais barato
** Limitação de taxa **
- Cota de assinatura esgotada → Fallback para GLM/MiniMax
- Adicionar combinação: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**O token OAuth expirou**
- Atualizado automaticamente pelo OmniRoute
- Se os problemas persistirem: Painel → Provedor → Reconectar
**Custos elevados**
- Verifique as estatísticas de uso em Painel → Custos
- Mude o modelo primário para GLM/MiniMax
- Use o nível gratuito (Gemini CLI, iFlow) para tarefas não críticas
**Painel abre na porta errada**
- Definir `PORT=20128` e `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Erros de sincronização na nuvem**
- Verifique `BASE_URL` aponta para sua instância em execução
- Verifique os pontos `CLOUD_URL` para o endpoint de nuvem esperado
- Mantenha os valores `NEXT_PUBLIC_*` alinhados com os valores do lado do servidor
**Primeiro login não funciona**
- Verifique `INITIAL_PASSWORD` em `.env`
- Se não definida, a senha substituta é `123456`
**Sem registros de solicitação**
- Definir `ENABLE_REQUEST_LOGS=true` em `.env`
**O teste de conexão mostra "Inválido" para provedores compatíveis com OpenAI**
- Muitos provedores não expõem um endpoint `/models`
- OmniRoute v1.0.6+ inclui validação de fallback por meio de conclusões de chat
- Certifique-se de que o URL base inclua o sufixo `/v1`
</details>
---
@@ -1176,85 +1104,6 @@ Licença MIT - consulte [LICENSE](LICENSE) para obter detalhes.
---
---
## 🇧🇷 OmniRoute — Gateway de IA Gratuito
<a name="-omniroute--gateway-de-ia-gratuito"></a>
### Nunca pare de codificar. Roteamento inteligente para **modelos de IA GRATUITOS e de baixo custo** com fallback automático.
_Seu proxy universal de API — um endpoint, mais de 36 provedores, tempo de inatividade zero._
### 🌐 Internacionalização (i18n)
O painel do OmniRoute suporta **múltiplos idiomas**. Atualmente disponível em:
| Idioma | Código | Estado |
| --------------------- | ------- | ----------- |
| 🇺🇸 Inglês | `en` | ✅ Completo |
| 🇧🇷 Português (Brasil) | `pt-BR` | ✅ Completo |
**Para alterar o idioma:** Clique no seletor de idioma (🇺🇸 PT) no cabeçalho do painel → selecione o idioma desejado.
**Para adicionar um novo idioma:**
1. Crie `src/i18n/messages/{codigo}.json` baseado em `en.json`
2. Adicione o código em `src/i18n/config.ts``LOCALES` e `LANGUAGES`
3. Reinicie o servidor
### ⚡ Início Rápido
```bash
# Instalar via npm
npx omniroute@latest
# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
```
### 🐳 Docker
```bash
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
```
### 🔑 Funcionalidades Principais
- **36+ provedores de IA** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek, e mais
- **Roteamento inteligente** — Fallback automático entre provedores
- **Tradução de formato** — OpenAI ↔ Claude ↔ Gemini automaticamente
- **Multi-conta** — Múltiplas contas por provedor com seleção inteligente
- **Cache semântico** — Reduz custos e latência
- **OAuth automático** — Tokens renovam automaticamente
- **Combos personalizados** — 6 estratégias de roteamento
- **Dashboard completo** — Monitoramento, logs, análises, configurações
- **Ferramentas CLI** — Configure Claude Code, Codex, Cursor, Cline com um clique
- **100% TypeScript** — Código limpo e digitado
### 📖 Documentação
| Documento | Descrição |
| ----------------------------------------------- | -------------------------------------------- |
| [Guia do Usuário](docs/USER_GUIDE.md) | Provedores, combos, CLI, implantar |
| [Referência da API](docs/API_REFERENCE.md) | Todos os endpoints com exemplos |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Problemas comuns e soluções |
| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura e portas do sistema |
| [Contribuição](CONTRIBUTING.md) | Configuração de desenvolvimento e diretrizes |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Guia completo: VM + nginx + Cloudflare |
### 📧Suporte
> 💬 **Entre para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tire dúvidas, compartilhe dicas e fique atualizado.
- **Site**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Problemas**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
---
<div align="center">
<sub>Construído com ❤️ para desenvolvedores que codificam 24 horas por dia, 7 dias por semana</sub>
<br/>

View File

@@ -3,8 +3,6 @@
# 🚀 OmniRoute — Gateway-ul gratuit AI
🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
### Nu opriți niciodată codificarea. Dirijare inteligentă către **modele AI GRATUITE și cu costuri reduse** cu rezervă automată.
_Proxy-ul dvs. universal API - un punct final, peste 36 de furnizori, zero timpi de nefuncționare._
@@ -298,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Cazuri de utilizare
### Cazul 1: „Am abonament Claude Pro”
**Problemă:** Cota expiră neutilizată, limitele ratei în timpul codării grele
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Cazul 2: „Vreau cost zero”
**Problemă:** Nu-mi permit abonamente, au nevoie de codare AI de încredere
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Cazul 3: „Am nevoie de codare 24/7, fără întreruperi”
**Problemă:** Termenele limită, nu-mi permit timpi de nefuncționare
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Cazul 4: „Vreau AI GRATUIT în OpenClaw”
**Problemă:** Aveți nevoie de asistent AI în aplicațiile de mesagerie, complet gratuit
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Caracteristici cheie
### 🧠 Core Routing & Intelligence
@@ -519,6 +456,67 @@ OmniRoute include un puternic Translator Playground încorporat cu **4 moduri**
---
## 🎯 Cazuri de utilizare
### Cazul 1: „Am abonament Claude Pro”
**Problemă:** Cota expiră neutilizată, limitele ratei în timpul codării grele
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Cazul 2: „Vreau cost zero”
**Problemă:** Nu-mi permit abonamente, au nevoie de codare AI de încredere
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Cazul 3: „Am nevoie de codare 24/7, fără întreruperi”
**Problemă:** Termenele limită, nu-mi permit timpi de nefuncționare
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Cazul 4: „Vreau AI GRATUIT în OpenClaw”
**Problemă:** Aveți nevoie de asistent AI în aplicațiile de mesagerie, complet gratuit
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Ghid de configurare
<details>
@@ -799,74 +797,6 @@ Settings → API Configuration:
---
## 📊 Modele disponibile
<details>
<summary><b>Vedeți toate modelele disponibile</b></summary>
**Cod Claude (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Codex (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**CLI Gemini (`gc/`)** - GRATUIT:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**Copilot GitHub (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - credite GRATUITE:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- Mai mult de 50 de modele pe [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - 0,6 USD/1 milion:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - 0,2 USD/1 milion:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - GRATUIT:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - GRATUIT:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - GRATUIT:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - peste 100 de modele:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Orice model de la [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Evaluări (Evaluări)
OmniRoute include un cadru de evaluare încorporat pentru a testa calitatea răspunsului LLM față de un set de aur. Accesați-l prin **Analitice → Evaluări** în tabloul de bord.
@@ -890,13 +820,64 @@ OmniRoute include un cadru de evaluare încorporat pentru a testa calitatea răs
---
## 🔐 OAuth em Servidor Remoto (Configurare OAuth la distanță)
## 🐛 Depanare
<details>
<summary><b>Faceți clic pentru a extinde ghidul de depanare</b></summary>
**„Modelul de limbă nu a furnizat mesaje”**
- Cota de furnizor epuizată → Verificați instrumentul de urmărire a cotei din tabloul de bord
- Soluție: utilizați alternativă combinată sau treceți la un nivel mai ieftin
**Limitarea ratei**
- Scăderea cotei de abonament → Fallback la GLM/MiniMax
- Adăugați combo: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**Tokenul OAuth a expirat**
- Reîmprospătat automat de OmniRoute
- Dacă problemele persistă: Dashboard → Provider → Reconnect
**Costuri mari**
- Verificați statisticile de utilizare în Tabloul de bord → Costuri
- Comutați modelul principal la GLM/MiniMax
- Utilizați nivelul gratuit (Gemini CLI, iFlow) pentru sarcini necritice
**Tabloul de bord se deschide pe portul greșit**
- Setați `PORT=20128` și `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Erori de sincronizare în cloud**
- Verificați `BASE_URL` puncte către instanța dvs. care rulează
- Verificați `CLOUD_URL` puncte către punctul final din cloud așteptat
- Păstrați valorile `NEXT_PUBLIC_*` aliniate cu valorile de pe partea serverului
**Prima conectare nu funcționează**
- Verificați `INITIAL_PASSWORD` în `.env`
- Dacă nu este setată, parola de rezervă este `123456`
**Fără jurnal de solicitare**
- Setați `ENABLE_REQUEST_LOGS=true` în `.env`
**Testul de conectare arată „Invalid” pentru furnizorii compatibili cu OpenAI**
- Mulți furnizori nu expun un punct final `/models`
- OmniRoute v1.0.6+ include validarea de rezervă prin finalizarea chatului
- Asigurați-vă că adresa URL de bază include sufixul `/v1`
### 🔐 OAuth em Servidor Remoto (Configurare OAuth la distanță)
<a name="oauth-em-servidor-remoto"></a>
> **⚠️ IMPORTANT pentru utilizatorii cu OmniRoute în VPS/Docker/servidor remoto**
### Por que o OAuth do Antigravity / Gemini CLI falha em serveres remotes?
#### Por que o OAuth do Antigravity / Gemini CLI falha em serveres remotes?
Pentru autentificare, **Antigravity** și **Gemini CLI** folosesc **Google OAuth 2.0**. O Google exige que a `redirect_uri` utilizat nu fluxo OAuth seja **exatamente** uma das URIs pre-cadastradas no Google Cloud Console do aplicative.
@@ -981,59 +962,6 @@ Nu vă rugăm să vă convingeți acum, dar este posibil să utilizați sau să
> Această soluție de soluționare funcționează deoarece codul de autorizare a URL-ului este valabil independent de redirecționare pentru a încărca sau nu.
---
## 🐛 Depanare
<details>
<summary><b>Faceți clic pentru a extinde ghidul de depanare</b></summary>
**„Modelul de limbă nu a furnizat mesaje”**
- Cota de furnizor epuizată → Verificați instrumentul de urmărire a cotei din tabloul de bord
- Soluție: utilizați alternativă combinată sau treceți la un nivel mai ieftin
**Limitarea ratei**
- Scăderea cotei de abonament → Fallback la GLM/MiniMax
- Adăugați combo: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**Tokenul OAuth a expirat**
- Reîmprospătat automat de OmniRoute
- Dacă problemele persistă: Dashboard → Provider → Reconnect
**Costuri mari**
- Verificați statisticile de utilizare în Tabloul de bord → Costuri
- Comutați modelul principal la GLM/MiniMax
- Utilizați nivelul gratuit (Gemini CLI, iFlow) pentru sarcini necritice
**Tabloul de bord se deschide pe portul greșit**
- Setați `PORT=20128` și `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Erori de sincronizare în cloud**
- Verificați `BASE_URL` puncte către instanța dvs. care rulează
- Verificați `CLOUD_URL` puncte către punctul final din cloud așteptat
- Păstrați valorile `NEXT_PUBLIC_*` aliniate cu valorile de pe partea serverului
**Prima conectare nu funcționează**
- Verificați `INITIAL_PASSWORD` în `.env`
- Dacă nu este setată, parola de rezervă este `123456`
**Fără jurnal de solicitare**
- Setați `ENABLE_REQUEST_LOGS=true` în `.env`
**Testul de conectare arată „Invalid” pentru furnizorii compatibili cu OpenAI**
- Mulți furnizori nu expun un punct final `/models`
- OmniRoute v1.0.6+ include validarea de rezervă prin finalizarea chatului
- Asigurați-vă că adresa URL de bază include sufixul `/v1`
</details>
---
@@ -1176,85 +1104,6 @@ Licență MIT - consultați [LICENSE](LICENSE) pentru detalii.
---
---
## 🇧🇷 OmniRoute — Gateway de IA Gratuito
<a name="-omniroute--gateway-de-ia-gratuito"></a>
### Nunca pare de codar. Roteamento inteligente pentru **modele de IA GRATUITE și de baixo custo** com fallback automático.
_Seu proxy universal de API — um endpoint, peste 36 de probe, zero downtime._
### 🌐 Internaționalizare (i18n)
O tablou de bord pentru OmniRoute suportă **multiplos idiomas**. De fapt, sunt disponibile:
| Idioma | Cod | Stare |
| ----------------------- | ------- | ---------- |
| 🇺🇸 engleză | `en` | ✅ Complet |
| 🇧🇷 Português (Brazilia) | `pt-BR` | ✅ Complet |
**Para trocar o idioma:** Clique no selector de idioma (🇺🇸 EN) no header do dashboard → selecione o idioma desejado.
**Para adicionar um nou idioma:**
1. Plânge `src/i18n/messages/{codigo}.json` bazat pe `en.json`
2. Adăugați codul în `src/i18n/config.ts``LOCALES` și `LANGUAGES`
3. Reinicie o servidor
### ⚡ Início Rápido
```bash
# Instalar via npm
npx omniroute@latest
# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
```
### 🐳 Docker
```bash
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
```
### 🔑 Funcționalități principale
- **36+ provedores de IA** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek, și mai mult
- **Roteamento inteligente** — Fallback automat entre provedores
- **Tradução de format** — OpenAI ↔ Claude ↔ Gemeni automaticamente
- **Multi-conta** — Múltiplas contas por provedor com seleção inteligente
- **Cache semântico** — Reduz custos e latência
- **OAuth automat** — Jetoane renovate automat
- **Combos personalizados** — 6 estratégias de roteamento
- **Dashboard complet** — Monitorizare, jurnale, analize, configurații
- **CLI Tools** — Configurați Claude Code, Codex, Cursor, Cline com um clique
- **100% TypeScript** — Código limpo e tipado
### 📖 Documentação
| Documento | Descriere |
| ----------------------------------------------- | ---------------------------------------- |
| [Guia do Usuário](docs/USER_GUIDE.md) | Provedores, combo-uri, CLI, implementare |
| [Referência da API](docs/API_REFERENCE.md) | Toate punctele finale, cum ar fi exemple |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Problemas comuns e soluções |
| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura e internos do sistema |
| [Contribuição](CONTRIBUTING.md) | Configurare de dezvoltare și ghiduri |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Ghid complet: VM + nginx + Cloudflare |
### 📧 Suport
> 💬 **Entre para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tire dúvidas, compartilhe dicas e fique atualizado.
- **Site web**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Probleme**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
---
<div align="center">
<sub>Construit cu ❤️ pentru dezvoltatorii care codifică 24/7</sub>
<br/>

View File

@@ -296,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Сценарии использования
### Сценарий 1: «У меня подписка Claude Pro»
**Проблема:** Квота истекает неиспользованной, лимиты скорости во время интенсивного программирования
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (используйте подписку полностью)
2. glm/glm-4.7 (дешёвый бэкап при исчерпании квоты)
3. if/kimi-k2-thinking (бесплатный аварийный fallback)
Месячная стоимость: $20 (подписка) + ~$5 (бэкап) = $25 итого
vs. $20 + упирание в лимиты = разочарование
```
### Сценарий 2: «Хочу нулевую стоимость»
**Проблема:** Не может позволить подписки, нужен надёжный AI для программирования
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K бесплатно/мес)
2. if/kimi-k2-thinking (неограниченно бесплатно)
3. qw/qwen3-coder-plus (неограниченно бесплатно)
Месячная стоимость: $0
Качество: Модели готовые к продакшену
```
### Сценарий 3: «Мне нужно программировать 24/7, без перерывов»
**Проблема:** Дедлайны, не может позволить простой
```
Combo: "always-on"
1. cc/claude-opus-4-6 (лучшее качество)
2. cx/gpt-5.2-codex (вторая подписка)
3. glm/glm-4.7 (дешёвый, ежедневный сброс)
4. minimax/MiniMax-M2.1 (самый дешёвый, сброс 5ч)
5. if/kimi-k2-thinking (бесплатно неограниченно)
Результат: 5 уровней fallback = нулевой простой
```
### Сценарий 4: «Хочу БЕСПЛАТНЫЙ AI в OpenClaw»
**Проблема:** Нужен AI-ассистент в мессенджерах, полностью бесплатно
```
Combo: "openclaw-free"
1. if/glm-4.7 (неограниченно бесплатно)
2. if/minimax-m2.1 (неограниченно бесплатно)
3. if/kimi-k2-thinking (неограниченно бесплатно)
Месячная стоимость: $0
Доступ через: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Основные функции
### 🧠 Маршрутизация и интеллект
@@ -498,6 +437,67 @@ Combo: "my-coding-stack"
---
## 🎯 Сценарии использования
### Сценарий 1: «У меня подписка Claude Pro»
**Проблема:** Квота истекает неиспользованной, лимиты скорости во время интенсивного программирования
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (используйте подписку полностью)
2. glm/glm-4.7 (дешёвый бэкап при исчерпании квоты)
3. if/kimi-k2-thinking (бесплатный аварийный fallback)
Месячная стоимость: $20 (подписка) + ~$5 (бэкап) = $25 итого
vs. $20 + упирание в лимиты = разочарование
```
### Сценарий 2: «Хочу нулевую стоимость»
**Проблема:** Не может позволить подписки, нужен надёжный AI для программирования
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K бесплатно/мес)
2. if/kimi-k2-thinking (неограниченно бесплатно)
3. qw/qwen3-coder-plus (неограниченно бесплатно)
Месячная стоимость: $0
Качество: Модели готовые к продакшену
```
### Сценарий 3: «Мне нужно программировать 24/7, без перерывов»
**Проблема:** Дедлайны, не может позволить простой
```
Combo: "always-on"
1. cc/claude-opus-4-6 (лучшее качество)
2. cx/gpt-5.2-codex (вторая подписка)
3. glm/glm-4.7 (дешёвый, ежедневный сброс)
4. minimax/MiniMax-M2.1 (самый дешёвый, сброс 5ч)
5. if/kimi-k2-thinking (бесплатно неограниченно)
Результат: 5 уровней fallback = нулевой простой
```
### Сценарий 4: «Хочу БЕСПЛАТНЫЙ AI в OpenClaw»
**Проблема:** Нужен AI-ассистент в мессенджерах, полностью бесплатно
```
Combo: "openclaw-free"
1. if/glm-4.7 (неограниченно бесплатно)
2. if/minimax-m2.1 (неограниченно бесплатно)
3. if/kimi-k2-thinking (неограниченно бесплатно)
Месячная стоимость: $0
Доступ через: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Руководство по настройке
<details>
@@ -778,74 +778,6 @@ Dashboard → CLI Tools → OpenClaw → Выбрать модель → При
---
## 📊 Доступные модели
<details>
<summary><b>Посмотреть все доступные модели</b></summary>
**Claude Code (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Codex (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - БЕСПЛАТНО:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub Copilot (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - БЕСПЛАТНЫЕ кредиты:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- 50+ моделей на [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - $0.6/1M:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - $0.2/1M:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - БЕСПЛАТНО:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - БЕСПЛАТНО:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - БЕСПЛАТНО:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100+ моделей:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Любая модель с [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Оценки (Evals)
OmniRoute включает встроенный фреймворк оценки для тестирования качества ответов LLM по golden set. Доступ через **Analytics → Evals** в dashboard.

View File

@@ -3,8 +3,6 @@
# 🚀 OmniRoute — bezplatná brána AI
🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
### Nikdy neprestávajte kódovať. Inteligentné smerovanie na **BEZPLATNÉ a nízkonákladové modely AI** s automatickým vrátením.
_Váš univerzálny proxy server API jeden koncový bod, 36+ poskytovateľov, nulové prestoje._
@@ -298,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Prípady použitia
### Prípad 1: „Mám predplatné Claude Pro“
**Problém:** Platnosť kvóty vyprší nevyužitá, obmedzenia sadzieb počas náročného kódovania
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Prípad 2: „Chcem nulové náklady“
**Problém:** Nemôžem si dovoliť predplatné, potrebujem spoľahlivé kódovanie AI
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Prípad 3: „Potrebujem kódovanie 24/7, žiadne prerušenia“
**Problém:** Termíny, nemôžem si dovoliť prestoje
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Prípad 4: „Chcem AI ZDARMA v OpenClaw“
**Problém:** Potrebujete asistenta AI v aplikáciách na odosielanie správ, úplne zadarmo
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Kľúčové vlastnosti
### 🧠 Základné smerovanie a inteligencia
@@ -520,6 +457,67 @@ OmniRoute obsahuje výkonné vstavané ihrisko pre prekladateľov so **4 režima
---
## 🎯 Prípady použitia
### Prípad 1: „Mám predplatné Claude Pro“
**Problém:** Platnosť kvóty vyprší nevyužitá, obmedzenia sadzieb počas náročného kódovania
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Prípad 2: „Chcem nulové náklady“
**Problém:** Nemôžem si dovoliť predplatné, potrebujem spoľahlivé kódovanie AI
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Prípad 3: „Potrebujem kódovanie 24/7, žiadne prerušenia“
**Problém:** Termíny, nemôžem si dovoliť prestoje
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Prípad 4: „Chcem AI ZDARMA v OpenClaw“
**Problém:** Potrebujete asistenta AI v aplikáciách na odosielanie správ, úplne zadarmo
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Sprievodca nastavením
<details>
@@ -800,74 +798,6 @@ Settings → API Configuration:
---
## 📊 Dostupné modely
<details>
<summary><b>Zobraziť všetky dostupné modely</b></summary>
**Claude Code (`cc/`)** Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Codex (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** ZDARMA:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub Copilot (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** BEZPLATNÉ kredity:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- 50+ ďalších modelov na [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** 0,6 USD/1 milión:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** 0,2 USD/1 milión:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** ZDARMA:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** ZDARMA:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** ZDARMA:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** viac ako 100 modelov:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Akýkoľvek model od [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Hodnotenia (Evals)
OmniRoute obsahuje vstavaný hodnotiaci rámec na testovanie kvality odozvy LLM oproti zlatému súboru. Prístup k nej získate cez **Analytics → Evals** na hlavnom paneli.
@@ -891,7 +821,58 @@ Predinštalovaná sada „OmniRoute Golden Set“ obsahuje 10 testovacích príp
---
## 🔐 OAuth em Servidor Remoto (Vzdialené nastavenie OAuth)
## 🐛 Riešenie problémov
<details>
<summary><b>Kliknutím rozbalíte sprievodcu riešením problémov</b></summary>
**„Jazykový model neposkytol správy“**
- Kvóta poskytovateľa je vyčerpaná → Skontrolujte sledovanie kvót na paneli
- Riešenie: Použite záložnú kombináciu alebo prejdite na lacnejšiu úroveň
**Obmedzenie sadzby**
- Vyčerpaná kvóta predplatného → Návrat na GLM/MiniMax
- Pridať kombináciu: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**Platnosť tokenu OAuth vypršala**
- Automaticky obnovuje OmniRoute
- Ak problémy pretrvávajú: Dashboard → Provider → Reconnect
**Vysoké náklady**
- Skontrolujte štatistiky používania v hlavnom paneli → Náklady
- Prepnite primárny model na GLM/MiniMax
- Používajte bezplatnú vrstvu (Gemini CLI, iFlow) pre nekritické úlohy
**Palubná doska sa otvára na nesprávnom porte**
- Nastavte `PORT=20128` a `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Chyby synchronizácie v cloude**
- Overte `BASE_URL` body na vašu spustenú inštanciu
Overte `CLOUD_URL` bodov k očakávanému koncovému bodu cloudu
- Ponechajte hodnoty `NEXT_PUBLIC_*` zarovnané s hodnotami na strane servera
**Prvé prihlásenie nefunguje**
- Skontrolujte `INITIAL_PASSWORD` v `.env`
Ak nie je nastavené, záložné heslo je `123456`
**Žiadne záznamy žiadostí**
- Nastaviť `ENABLE_REQUEST_LOGS=true` v `.env`
**Test pripojenia ukazuje „Neplatné“ pre poskytovateľov kompatibilných s OpenAI**
- Mnohí poskytovatelia nevystavujú koncový bod `/models`
- OmniRoute v1.0.6+ zahŕňa záložné overenie prostredníctvom dokončenia chatu
- Uistite sa, že základná adresa URL obsahuje príponu `/v1`
### 🔐 OAuth em Servidor Remoto (Vzdialené nastavenie OAuth)
<a name="oauth-em-servidor-remoto"></a>
@@ -982,59 +963,6 @@ Ak chcete získať prístup k dôvere, môžete použiť **príručku URL**:
> Toto riešenie funguje pomocou autorizačného kódu na adrese URL a nezávislého presmerovania.
---
## 🐛 Riešenie problémov
<details>
<summary><b>Kliknutím rozbalíte sprievodcu riešením problémov</b></summary>
**„Jazykový model neposkytol správy“**
- Kvóta poskytovateľa je vyčerpaná → Skontrolujte sledovanie kvót na paneli
- Riešenie: Použite záložnú kombináciu alebo prejdite na lacnejšiu úroveň
**Obmedzenie sadzby**
- Vyčerpaná kvóta predplatného → Návrat na GLM/MiniMax
- Pridať kombináciu: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**Platnosť tokenu OAuth vypršala**
- Automaticky obnovuje OmniRoute
- Ak problémy pretrvávajú: Dashboard → Provider → Reconnect
**Vysoké náklady**
- Skontrolujte štatistiky používania v hlavnom paneli → Náklady
- Prepnite primárny model na GLM/MiniMax
- Používajte bezplatnú vrstvu (Gemini CLI, iFlow) pre nekritické úlohy
**Palubná doska sa otvára na nesprávnom porte**
- Nastavte `PORT=20128` a `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Chyby synchronizácie v cloude**
- Overte `BASE_URL` body na vašu spustenú inštanciu
Overte `CLOUD_URL` bodov k očakávanému koncovému bodu cloudu
- Ponechajte hodnoty `NEXT_PUBLIC_*` zarovnané s hodnotami na strane servera
**Prvé prihlásenie nefunguje**
- Skontrolujte `INITIAL_PASSWORD` v `.env`
Ak nie je nastavené, záložné heslo je `123456`
**Žiadne záznamy žiadostí**
- Nastaviť `ENABLE_REQUEST_LOGS=true` v `.env`
**Test pripojenia ukazuje „Neplatné“ pre poskytovateľov kompatibilných s OpenAI**
- Mnohí poskytovatelia nevystavujú koncový bod `/models`
- OmniRoute v1.0.6+ zahŕňa záložné overenie prostredníctvom dokončenia chatu
- Uistite sa, že základná adresa URL obsahuje príponu `/v1`
</details>
---
@@ -1177,85 +1105,6 @@ Licencia MIT podrobnosti nájdete na stránke [LICENSE](LICENSE).
---
---
## 🇧🇷 OmniRoute — Gateway de IA Gratuito
<a name="-omniroute--gateway-de-ia-gratuito"></a>
### Nunca pare de codar. Roteamento inteligentné pre **modely IA GRATUITOS a vlastné zálohy** s záložným autom.
_Seu proxy universal de API um koncový bod, 36+ overorov, nulové prestoje._
### 🌐 Internacionalização (i18n)
Prístrojová doska podporuje OmniRoute **múltiplos idiomas**. Aktuálne k dispozícii:
| Idióm | Código | Stav |
| ----------------------- | ------- | ------------ |
| 🇺🇸 anglicky | `en` | ✅ Kompletné |
| 🇧🇷 Português (Brazília) | `pt-BR` | ✅ Kompletné |
**Para trocar o idioma:** Clique no seletor de idioma (🇺🇸 EN) no header to dashboard → selectione o idioma desejado.
**Pre nový idióm:**
1. Plač `src/i18n/messages/{codigo}.json` baseado em `en.json`
2. Adicione o kódigo em `src/i18n/config.ts``LOCALES` a `LANGUAGES`
3. Reinicie o servidor
### ⚡ Início Rápido
```bash
# Instalar via npm
npx omniroute@latest
# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
```
### 🐳 Docker
```bash
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
```
### 🔑 Funcionalidades Principais
- **36+ overores de IA** Claude, GPT, Gemini, Llama, Qwen, DeepSeek a ďalšie
- **Roteamento inteligente** — Záložné automaty entre proveores
- **Preklad formátu** — OpenAI ↔ Claude ↔ Gemini automaticamente
- **Multi-conta** — Viacnásobné obsahy s vybranými inteligentnými
- **Cache semântico** — Reduz custos e latência
- **OAuth automático** — Tokeny renovam automaticamente
- **Combos personalizados** — 6 estratégias de roteamento
- **Úplný informačný panel** Monitorovanie, protokoly, analýzy, konfigurácie
- **Nástroje CLI** Konfigurácia Claude Code, Codex, Cursor, Cline com um clique
- **100 % TypeScript** jednoduché a jednoduché označenie
### 📖 Dokumentácia
| Documento | Popis |
| ----------------------------------------------- | --------------------------------------- |
| [Guia do Usuário](docs/USER_GUIDE.md) | Provedores, combá, CLI, deploy |
| [Referência da API](docs/API_REFERENCE.md) | Todos os endpoints com exemplos |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Problemas comuns e soluções |
| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura e internos do systému |
| [Contribuição](CONTRIBUTING.md) | Nastavenie desenvolvimento e guidelines |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Guia komplet: VM + nginx + Cloudflare |
### 📧 Podporte
> 💬 **Entre para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — pneumatiky dúvidas, compartilhe dicas e fique atualizado.
- **Web**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Problémy**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
---
<div align="center">
<sub>Vytvorené pomocou ❤️ pre vývojárov, ktorí kódujú 24/7</sub>
<br/>

View File

@@ -3,8 +3,6 @@
# 🚀 OmniRoute — Den kostnadsfria AI-gatewayen
🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
### Sluta aldrig koda. Smart routing till **GRATIS & lågkostnads AI-modeller** med automatisk reserv.
_Din universella API-proxy — en slutpunkt, 36+ leverantörer, noll driftstopp._
@@ -298,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Användningsfall
### Fall 1: "Jag har Claude Pro-abonnemang"
**Problem:** Kvoten går ut oanvänd, hastighetsgränser under tung kodning
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Fall 2: "Jag vill ha noll kostnad"
**Problem:** Har inte råd med prenumerationer, behöver pålitlig AI-kodning
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Fall 3: "Jag behöver kodning dygnet runt, inga avbrott"
**Problem:** Deadlines, har inte råd med driftstopp
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Fall 4: "Jag vill ha GRATIS AI i OpenClaw"
**Problem:** Behöver AI-assistent i meddelandeappar, helt gratis
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Nyckelfunktioner
### 🧠 Core Routing & Intelligence
@@ -519,6 +456,67 @@ OmniRoute inkluderar en kraftfull inbyggd översättarlekplats med **4 lägen**
---
## 🎯 Användningsfall
### Fall 1: "Jag har Claude Pro-abonnemang"
**Problem:** Kvoten går ut oanvänd, hastighetsgränser under tung kodning
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Fall 2: "Jag vill ha noll kostnad"
**Problem:** Har inte råd med prenumerationer, behöver pålitlig AI-kodning
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Fall 3: "Jag behöver kodning dygnet runt, inga avbrott"
**Problem:** Deadlines, har inte råd med driftstopp
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Fall 4: "Jag vill ha GRATIS AI i OpenClaw"
**Problem:** Behöver AI-assistent i meddelandeappar, helt gratis
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Installationsguide
<details>
@@ -799,74 +797,6 @@ Settings → API Configuration:
---
## 📊 Tillgängliga modeller
<details>
<summary><b>Visa alla tillgängliga modeller</b></summary>
**Claude Code (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Codex (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - GRATIS:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub Copilot (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - GRATIS krediter:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- 50+ modeller till på [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - $0,6/1M:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - $0,2/1M:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - GRATIS:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - GRATIS:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - GRATIS:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100+ modeller:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Alla modeller från [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Utvärderingar (Evals)
OmniRoute inkluderar ett inbyggt utvärderingsramverk för att testa LLM-svarskvalitet mot en gyllene uppsättning. Få åtkomst till det via **Analytics → Evals** i instrumentpanelen.
@@ -890,7 +820,58 @@ Det förinstallerade "OmniRoute Golden Set" innehåller 10 testfall som täcker:
---
## 🔐 OAuth em Servidor Remoto (Remote OAuth Setup)
## 🐛 Felsökning
<details>
<summary><b>Klicka för att expandera felsökningsguide</b></summary>
**"Språkmodellen gav inga meddelanden"**
- Leverantörskvoten är slut → Kontrollera instrumentpanelens kvotföljare
- Lösning: Använd kombinationsalternativ eller byt till billigare nivå
**Taxebegränsning**
- Prenumerationskvot ute → Fallback till GLM/MiniMax
- Lägg till kombination: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**OAuth-token har löpt ut**
- Automatisk uppdatering av OmniRoute
- Om problemen kvarstår: Dashboard → Leverantör → Återanslut
**Höga kostnader**
- Kontrollera användningsstatistik i Dashboard → Kostnader
- Byt primär modell till GLM/MiniMax
- Använd gratis nivå (Gemini CLI, iFlow) för icke-kritiska uppgifter
**Dashboard öppnas på fel port**
- Set `PORT=20128` och `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Molnsynkroniseringsfel**
- Verifiera att `BASE_URL` pekar på din löpinstans
- Verifiera `CLOUD_URL` poäng till din förväntade molnslutpunkt
- Håll `NEXT_PUBLIC_*` värden i linje med värden på serversidan
**Första inloggningen fungerar inte**
- Kontrollera `INITIAL_PASSWORD` i `.env`
- Om det inte är inställt är reservlösenordet `123456`
**Inga förfrågningsloggar**
- Ställ in `ENABLE_REQUEST_LOGS=true` i `.env`
**Anslutningstest visar "Invalid" för OpenAI-kompatibla leverantörer**
- Många leverantörer exponerar inte en `/models` slutpunkt
- OmniRoute v1.0.6+ inkluderar reservvalidering via chattslutföranden
- Se till att baswebbadressen innehåller suffixet `/v1`
### 🔐 OAuth em Servidor Remoto (Remote OAuth Setup)
<a name="oauth-em-servidor-remoto"></a>
@@ -981,59 +962,6 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux
> Este workaround funciona porque o código de autorização na URL é válido independente do redirect ter carregado ou não.
---
## 🐛 Felsökning
<details>
<summary><b>Klicka för att expandera felsökningsguide</b></summary>
**"Språkmodellen gav inga meddelanden"**
- Leverantörskvoten är slut → Kontrollera instrumentpanelens kvotföljare
- Lösning: Använd kombinationsalternativ eller byt till billigare nivå
**Taxebegränsning**
- Prenumerationskvot ute → Fallback till GLM/MiniMax
- Lägg till kombination: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**OAuth-token har löpt ut**
- Automatisk uppdatering av OmniRoute
- Om problemen kvarstår: Dashboard → Leverantör → Återanslut
**Höga kostnader**
- Kontrollera användningsstatistik i Dashboard → Kostnader
- Byt primär modell till GLM/MiniMax
- Använd gratis nivå (Gemini CLI, iFlow) för icke-kritiska uppgifter
**Dashboard öppnas på fel port**
- Set `PORT=20128` och `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Molnsynkroniseringsfel**
- Verifiera att `BASE_URL` pekar på din löpinstans
- Verifiera `CLOUD_URL` poäng till din förväntade molnslutpunkt
- Håll `NEXT_PUBLIC_*` värden i linje med värden på serversidan
**Första inloggningen fungerar inte**
- Kontrollera `INITIAL_PASSWORD` i `.env`
- Om det inte är inställt är reservlösenordet `123456`
**Inga förfrågningsloggar**
- Ställ in `ENABLE_REQUEST_LOGS=true` i `.env`
**Anslutningstest visar "Invalid" för OpenAI-kompatibla leverantörer**
- Många leverantörer exponerar inte en `/models` slutpunkt
- OmniRoute v1.0.6+ inkluderar reservvalidering via chattslutföranden
- Se till att baswebbadressen innehåller suffixet `/v1`
</details>
---
@@ -1176,85 +1104,6 @@ MIT-licens - se [LICENSE](LICENSE) för detaljer.
---
---
## 🇧🇷 OmniRoute — Gateway de IA Gratuito
<a name="-omniroute--gateway-de-ia-gratuito"></a>
### Nunca pare de codar. Roteamento inteligente para **modeller de IA GRATUITOS e de baixo custo** com reservautomatisk.
_Seu proxy universal de API — um endpoint, 36+ tester, noll driftstopp._
### 🌐 Internacionalização (i18n)
O instrumentpanelen gör OmniRoute stöder **múltiplos idiomas**. Attualmente disponível em:
| Idiom | Código | Status |
| ------------------------ | ------- | ----------- |
| 🇺🇸 engelska | `en` | ✅ Komplett |
| 🇧🇷 Português (Brasilien) | `pt-BR` | ✅ Komplett |
**Para trocar o idioma:** Clique no selector de idioma (🇺🇸 EN) no header do dashboard → selecione o idioma desejado.
**För att lägga till ett nytt uttryck:**
1. Crie `src/i18n/messages/{codigo}.json` baseado em `en.json`
2. Adicione o código em `src/i18n/config.ts``LOCALES` och `LANGUAGES`
3. Reinicie o servidor
### ⚡ Início Rápido
```bash
# Instalar via npm
npx omniroute@latest
# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
```
### 🐳 Hamnarbetare
```bash
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
```
### 🔑 Funcionalidades Principais
- **36+ provedores de IA** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek, e mais
- **Roteamento inteligente** — Fallback automático entre provedores
- **Tradução de formato** — OpenAI ↔ Claude ↔ Gemini automaticamente
- **Multi-conta** — Múltiplas contas por provedor com seleção inteligente
- **Cache semântico** — Reduz custos e latência
- **OAuth automático** — Tokens renovam automaticamente
- **Combos personalizados** — 6 estratégias de roteamento
- **Dashboard komplett** — Övervakning, loggar, analyser, konfigurationer
- **CLI-verktyg** — Konfigurera Claude Code, Codex, Cursor, Cline com um clique
- **100 % TypeScript** — Código limpo e tipado
### 📖 Dokumentation
| Dokument | Beskrivning |
| ----------------------------------------------- | --------------------------------------------- |
| [Guia do Usuário](docs/USER_GUIDE.md) | Provedores, combos, CLI, distribuera |
| [Referência da API](docs/API_REFERENCE.md) | Todos os endpoints com exemplos |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Problemas comuns e soluções |
| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura e internos do sistema |
| [Contribuição](CONTRIBUTING.md) | Inställning av desenvolvimento och riktlinjer |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Komplettera med: VM + nginx + Cloudflare |
### 📧 Stöd
> 💬 **Entre para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tire dúvidas, compartilhe dicas e fique atualizado.
- **Webbplats**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Frågor**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
---
<div align="center">
<sub>Byggd med ❤️ för utvecklare som kodar 24/7</sub>
<br/>

View File

@@ -3,8 +3,6 @@
# 🚀 OmniRoute — เกตเวย์ AI ฟรี
🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
### อย่าหยุดเขียนโค้ด การกำหนดเส้นทางอัจฉริยะไปยัง **โมเดล AI ฟรีและราคาประหยัด** พร้อมทางเลือกสำรองอัตโนมัติ
_พร็อกซี API สากลของคุณ — จุดสิ้นสุดเดียว ผู้ให้บริการมากกว่า 36 ราย เวลาหยุดทำงานเป็นศูนย์_
@@ -298,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 กรณีการใช้งาน
### กรณีที่ 1: "ฉันสมัครสมาชิก Claude Pro"
**ปัญหา:** โควต้าหมดอายุโดยไม่ได้ใช้ อัตราจำกัดระหว่างการเขียนโค้ดจำนวนมาก
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### กรณีที่ 2: "ฉันต้องการต้นทุนเป็นศูนย์"
**ปัญหา:** ไม่สามารถสมัครสมาชิกได้ ต้องการการเข้ารหัส AI ที่เชื่อถือได้
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### กรณีที่ 3: "ฉันต้องการการเข้ารหัสตลอด 24 ชั่วโมงทุกวัน ไม่มีการหยุดชะงัก"
**ปัญหา:** กำหนดเวลา ไม่สามารถหยุดการทำงานได้
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### กรณีที่ 4: "ฉันต้องการ AI ฟรีใน OpenClaw"
**ปัญหา:** ต้องการผู้ช่วย AI ในแอปส่งข้อความ ไม่มีค่าใช้จ่ายใดๆ ทั้งสิ้น
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 คุณสมบัติที่สำคัญ
### 🧠 การกำหนดเส้นทางหลักและความฉลาด
@@ -518,6 +455,67 @@ OmniRoute มี Translator Playground ในตัวอันทรงพล
---
## 🎯 กรณีการใช้งาน
### กรณีที่ 1: "ฉันสมัครสมาชิก Claude Pro"
**ปัญหา:** โควต้าหมดอายุโดยไม่ได้ใช้ อัตราจำกัดระหว่างการเขียนโค้ดจำนวนมาก
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### กรณีที่ 2: "ฉันต้องการต้นทุนเป็นศูนย์"
**ปัญหา:** ไม่สามารถสมัครสมาชิกได้ ต้องการการเข้ารหัส AI ที่เชื่อถือได้
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### กรณีที่ 3: "ฉันต้องการการเข้ารหัสตลอด 24 ชั่วโมงทุกวัน ไม่มีการหยุดชะงัก"
**ปัญหา:** กำหนดเวลา ไม่สามารถหยุดการทำงานได้
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### กรณีที่ 4: "ฉันต้องการ AI ฟรีใน OpenClaw"
**ปัญหา:** ต้องการผู้ช่วย AI ในแอปส่งข้อความ ไม่มีค่าใช้จ่ายใดๆ ทั้งสิ้น
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 คู่มือการตั้งค่า
<details>
@@ -792,74 +790,6 @@ Settings → API Configuration:
---
## 📊 รุ่นที่มีจำหน่าย
<details>
<summary><b>ดูรุ่นที่มีทั้งหมด</b></summary>
**รหัสโคลด (`cc/`)** - โปร/สูงสุด:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**โคเด็กซ์ (`cx/`)** - บวก/โปร:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**ราศีเมถุน CLI (`gc/`)** - ฟรี:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**โปรแกรมควบคุม GitHub (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - เครดิตฟรี:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- มากกว่า 50 รุ่นบน [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - $0.6/1M:
- `glm/glm-4.7`
**มินิแม็กซ์ (`minimax/`)** - $0.2/1M:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - ฟรี:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**คิวเวน (`qw/`)** - ฟรี:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**คิโระ (`kr/`)** - ฟรี:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - มากกว่า 100 รุ่น:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- รุ่นใดก็ได้จาก [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 การประเมินผล (Evals)
OmniRoute มีกรอบการประเมินในตัวเพื่อทดสอบคุณภาพการตอบสนองของ LLM เทียบกับชุดทอง เข้าถึงได้ผ่านทาง **Analytics → Evals** ในแดชบอร์ด
@@ -883,7 +813,57 @@ OmniRoute มีกรอบการประเมินในตัวเพ
---
## 🔐 OAuth ในเซิร์ฟเวอร์ Remoto (การตั้งค่า OAuth ระยะไกล)
## 🐛 การแก้ไขปัญหา
<details>
<summary><b>คลิกเพื่อขยายคำแนะนำการแก้ปัญหา</b></summary>
**"โมเดลภาษาไม่ได้ระบุข้อความ"**
- โควต้าผู้ให้บริการหมด → ตรวจสอบตัวติดตามโควต้าแดชบอร์ด
- วิธีแก้ไข: ใช้ทางเลือกแบบคอมโบหรือเปลี่ยนไปใช้ระดับที่ถูกกว่า
**จำกัดอัตรา**
- โควต้าการสมัครสมาชิกหมด → สำรองไปที่ GLM/MiniMax
- เพิ่มคอมโบ: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**โทเค็น OAuth หมดอายุแล้ว**
- รีเฟรชอัตโนมัติโดย OmniRoute
- หากปัญหายังคงอยู่: แดชบอร์ด → ผู้ให้บริการ → เชื่อมต่อใหม่
**ค่าใช้จ่ายสูง**
- ตรวจสอบสถิติการใช้งานในแดชบอร์ด → ต้นทุน
- เปลี่ยนโมเดลหลักเป็น GLM/MiniMax
- ใช้ระดับฟรี (Gemini CLI, iFlow) สำหรับงานที่ไม่สำคัญ
**แดชบอร์ดเปิดผิดพอร์ต**
- ตั้งค่า `PORT=20128` และ `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**ข้อผิดพลาดในการซิงค์คลาวด์**
- ตรวจสอบ `BASE_URL` ชี้ไปยังอินสแตนซ์ที่ทำงานอยู่ของคุณ
- ตรวจสอบ `CLOUD_URL` ชี้ไปยังจุดปลายทางคลาวด์ที่คุณคาดหวัง
- เก็บค่า `NEXT_PUBLIC_*` ให้สอดคล้องกับค่าฝั่งเซิร์ฟเวอร์
**เข้าสู่ระบบครั้งแรกใช้งานไม่ได้**
- ตรวจสอบ `INITIAL_PASSWORD` ใน `.env`
- หากไม่ได้ตั้งค่า รหัสผ่านสำรองจะเป็น `123456`
** ไม่มีบันทึกคำขอ **
- ตั้งค่า `ENABLE_REQUEST_LOGS=true` ใน `.env`
**การทดสอบการเชื่อมต่อแสดงว่า "ไม่ถูกต้อง" สำหรับผู้ให้บริการที่รองรับ OpenAI**
- ผู้ให้บริการหลายรายไม่เปิดเผยปลายทาง `/models`
- OmniRoute v1.0.6+ มีการตรวจสอบทางเลือกผ่านการแชทให้เสร็จสิ้น
- ตรวจสอบให้แน่ใจว่า URL ฐานมีคำต่อท้าย `/v1`
### 🔐 OAuth ในเซิร์ฟเวอร์ Remoto (การตั้งค่า OAuth ระยะไกล)
<a name="oauth-em-servidor-remoto"></a>
@@ -974,58 +954,6 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux
> วิธีแก้ปัญหาเบื้องต้นคือทำการเปลี่ยนเส้นทางโดยอัตโนมัติและทำการเปลี่ยนเส้นทางโดยอัตโนมัติ
---
## 🐛 การแก้ไขปัญหา
<details>
<summary><b>คลิกเพื่อขยายคำแนะนำการแก้ปัญหา</b></summary>
**"โมเดลภาษาไม่ได้ระบุข้อความ"**
- โควต้าผู้ให้บริการหมด → ตรวจสอบตัวติดตามโควต้าแดชบอร์ด
- วิธีแก้ไข: ใช้ทางเลือกแบบคอมโบหรือเปลี่ยนไปใช้ระดับที่ถูกกว่า
**จำกัดอัตรา**
- โควต้าการสมัครสมาชิกหมด → สำรองไปที่ GLM/MiniMax
- เพิ่มคอมโบ: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**โทเค็น OAuth หมดอายุแล้ว**
- รีเฟรชอัตโนมัติโดย OmniRoute
- หากปัญหายังคงอยู่: แดชบอร์ด → ผู้ให้บริการ → เชื่อมต่อใหม่
**ค่าใช้จ่ายสูง**
- ตรวจสอบสถิติการใช้งานในแดชบอร์ด → ต้นทุน
- เปลี่ยนโมเดลหลักเป็น GLM/MiniMax
- ใช้ระดับฟรี (Gemini CLI, iFlow) สำหรับงานที่ไม่สำคัญ
**แดชบอร์ดเปิดผิดพอร์ต**
- ตั้งค่า `PORT=20128` และ `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**ข้อผิดพลาดในการซิงค์คลาวด์**
- ตรวจสอบ `BASE_URL` ชี้ไปยังอินสแตนซ์ที่ทำงานอยู่ของคุณ
- ตรวจสอบ `CLOUD_URL` ชี้ไปยังจุดปลายทางคลาวด์ที่คุณคาดหวัง
- เก็บค่า `NEXT_PUBLIC_*` ให้สอดคล้องกับค่าฝั่งเซิร์ฟเวอร์
**เข้าสู่ระบบครั้งแรกใช้งานไม่ได้**
- ตรวจสอบ `INITIAL_PASSWORD` ใน `.env`
- หากไม่ได้ตั้งค่า รหัสผ่านสำรองจะเป็น `123456`
** ไม่มีบันทึกคำขอ **
- ตั้งค่า `ENABLE_REQUEST_LOGS=true` ใน `.env`
**การทดสอบการเชื่อมต่อแสดงว่า "ไม่ถูกต้อง" สำหรับผู้ให้บริการที่รองรับ OpenAI**
- ผู้ให้บริการหลายรายไม่เปิดเผยปลายทาง `/models`
- OmniRoute v1.0.6+ มีการตรวจสอบทางเลือกผ่านการแชทให้เสร็จสิ้น
- ตรวจสอบให้แน่ใจว่า URL ฐานมีคำต่อท้าย `/v1`
</details>
---
@@ -1167,85 +1095,6 @@ gh release create v1.0.6 --title "v1.0.6" --generate-notes
---
---
## 🇧🇷 OmniRoute — เกตเวย์ IA ฟรี
<a name="-omniroute--gateway-de-ia-gratuito"></a>
### นันคา พาเร เด โคดาร์. อัจฉริยะสำหรับ **แบบจำลอง IA ฟรีและการปรับแต่ง** com ทางเลือกอัตโนมัติ
_Seu proxy universal de API — อืม endpoint, 36+ พิสูจน์แล้ว, ศูนย์หยุดทำงาน._
### 🌐 อินเตอร์นาซิอองนาลลิซาเซา (i18n)
O แดชบอร์ดรองรับ OmniRoute **múltiplos idiomas** สาเหตุที่แท้จริงคือ:
| ไอดิโอมา | โคดิโก้ | สถานะ |
| -------------------- | ------- | ------ |
| 🇮🇩 อังกฤษ | `en` | ✅ ครบ |
| 🇧🇷 โปรตุเกส (บราซิล) | `pt-BR` | ✅ ครบ |
**Para trocar o idioma:** Clique no seletor de idioma (USA) no header do Dashboard → selecione o idioma desejado.
**สำหรับการอ้างอิง um novo idioma:**
1. ร้องไห้ `src/i18n/messages/{codigo}.json` ฐาน `en.json`
2. อ้างอิงถึง `src/i18n/config.ts``LOCALES` และ `LANGUAGES`
3. Reinicie หรือผู้รับใช้
### ⚡ Início Rapido
```bash
# Instalar via npm
npx omniroute@latest
# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
```
### 🐳 ด็อคเกอร์
```bash
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
```
### 🔑 Funcionalidades Principais
- ** IA มากกว่า 36 รายการ ** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek และอีเมลอื่น ๆ
- **Roteamento inteligente** — ทางเลือกสำรองอัตโนมัติ
- **รูปแบบการจัดรูปแบบ** — OpenAI ↔ Claude ↔ Gemini automaticamente
- **หลายคอนตา** — Múltiplas contas por provendor com seleção inteligente
- **ความหมายแคช** — Reduz custos e latência
- **OAuth automático** — โทเค็นปรับปรุงอัตโนมัติ
- **คอมโบส่วนบุคคล** — 6 estratégias de roteamento
- **แดชบอร์ดที่สมบูรณ์** — การตรวจสอบ บันทึก การวิเคราะห์ การกำหนดค่า
- **เครื่องมือ CLI** — กำหนดค่ารหัส Claude, Codex, เคอร์เซอร์, ไคลน์
- **TypeScript100%** — รวดเร็วทันใจ
### 📖 เอกสารประกอบ
| เอกสาร | คำอธิบาย |
| ----------------------------------------------- | --------------------------------- |
| [Guia do Usuário](docs/USER_GUIDE.md) | Provedores, คอมโบ, CLI, ปรับใช้ |
| [Referência da API](docs/API_REFERENCE.md) | Todos os endpoints com exemplos |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Problemas comuns e soluções |
| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura e internos do sistema |
| [Contribuição](CONTRIBUTING.md) | ตั้งค่าแนวทางการพัฒนา |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | สมบูรณ์: VM + nginx + Cloudflare |
### 📧 สนับสนุน
> 💬 **เริ่มต้นการเดินทาง!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tyre dúvidas, compartilhe dicas e fique atualizado.
- **เว็บไซต์**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **ปัญหา**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
---
<div align="center">
<sub>สร้างด้วย ❤️ สำหรับนักพัฒนาที่เขียนโค้ด 24/7</sub>
<br/>

View File

@@ -3,8 +3,6 @@
# 🚀 OmniRoute — безкоштовний ШІ-шлюз
🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
### Ніколи не припиняйте кодувати. Розумна маршрутизація до **БЕЗКОШТОВНИХ і недорогих моделей штучного інтелекту** з автоматичним резервним копіюванням.
_Ваш універсальний API-проксі — одна кінцева точка, понад 36 провайдерів, нуль простоїв._
@@ -298,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Випадки використання
### Випадок 1: «У мене є підписка на Claude Pro»
**Проблема:** Квота закінчується невикористаною, обмеження швидкості під час інтенсивного кодування
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Випадок 2: "Я хочу нульову вартість"
**Проблема:** не можу дозволити собі підписку, потрібне надійне кодування ШІ
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Випадок 3: «Мені потрібне кодування 24/7, без перерв»
**Проблема:** Дедлайни, не можу дозволити собі простою
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Випадок 4: «Я хочу БЕЗКОШТОВНОГО ШІ в OpenClaw»
**Проблема:** потрібен помічник штучного інтелекту в програмах для обміну повідомленнями, повністю безкоштовний
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Основні характеристики
### 🧠 Основна маршрутизація та інтелект
@@ -519,6 +456,67 @@ OmniRoute містить потужний вбудований Translator Playgr
---
## 🎯 Випадки використання
### Випадок 1: «У мене є підписка на Claude Pro»
**Проблема:** Квота закінчується невикористаною, обмеження швидкості під час інтенсивного кодування
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Випадок 2: "Я хочу нульову вартість"
**Проблема:** не можу дозволити собі підписку, потрібне надійне кодування ШІ
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Випадок 3: «Мені потрібне кодування 24/7, без перерв»
**Проблема:** Дедлайни, не можу дозволити собі простою
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Випадок 4: «Я хочу БЕЗКОШТОВНОГО ШІ в OpenClaw»
**Проблема:** потрібен помічник штучного інтелекту в програмах для обміну повідомленнями, повністю безкоштовний
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Посібник із налаштування
<details>
@@ -799,74 +797,6 @@ Settings → API Configuration:
---
## 📊 Доступні моделі
<details>
<summary><b>Переглянути всі доступні моделі</b></summary>
**Claude Code (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Codex (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - БЕЗКОШТОВНО:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**Копілот GitHub (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - БЕЗКОШТОВНІ кредити:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- більше 50 моделей на [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - 0,6 $/1 млн:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - $0,2/1 млн.:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - БЕЗКОШТОВНО:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - БЕЗКОШТОВНО:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - БЕЗКОШТОВНО:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100+ моделей:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Будь-яка модель від [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Оцінки (Evals)
OmniRoute містить вбудовану систему оцінювання для перевірки якості відповіді LLM на відповідність золотому набору. Доступ до нього через **Аналітика → Оцінки** на інформаційній панелі.
@@ -890,7 +820,60 @@ OmniRoute містить вбудовану систему оцінювання
---
## 🔐 OAuth em Servidor Remoto (віддалене налаштування OAuth)
## 🐛 Усунення несправностей
<details>
<summary><b>Натисніть, щоб розгорнути посібник з усунення несправностей</b></summary>
**"Мовна модель не надавала повідомлень"**
- Квота постачальника вичерпана → Перевірте систему відстеження квот на інформаційній панелі
- Рішення: скористайтеся комбінованим альтернативним варіантом або перейдіть на дешевший рівень
**Обмеження швидкості**
— Вичерпана квота на підписку → Повернення до GLM/MiniMax
- Додати комбо: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**Термін дії маркера OAuth минув**
— Автоматично оновлено OmniRoute
- Якщо проблеми не зникають: Інформаційна панель → Постачальник → Повторне підключення
**Високі витрати**
- Перевірте статистику використання в Інформаційній панелі → Витрати
- Переключіть основну модель на GLM/MiniMax
- Використовуйте безкоштовний рівень (Gemini CLI, iFlow) для некритичних завдань
**Інформаційна панель відкривається через неправильний порт**
- Встановити `PORT=20128` та `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Помилки хмарної синхронізації**
- Переконайтеся, що `BASE_URL` вказує на ваш запущений екземпляр
- Перевірте `CLOUD_URL` вказує на очікувану кінцеву точку хмари
- Зберігайте значення `NEXT_PUBLIC_*` у відповідності зі значеннями на стороні сервера
**Перший вхід не працює**
- Перевірте `INITIAL_PASSWORD` в `.env`
- Якщо не встановлено, резервний пароль `123456`
**Немає журналів запитів**
- Установіть `ENABLE_REQUEST_LOGS=true` в `.env`
**Тест з’єднання показує «Недійсне» для OpenAI-сумісних постачальників**
- Багато постачальників не розкривають кінцеву точку `/models`
- OmniRoute v1.0.6+ включає резервну перевірку через завершення чату
- Переконайтеся, що базова URL-адреса містить суфікс `/v1`
### 🔐 OAuth em Servidor Remoto (віддалене налаштування OAuth)
<a name="oauth-em-servidor-remoto"></a>
@@ -981,61 +964,6 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux
> Este workaround funciona porque o código de autorização na URL é válido independente do redirect ter carregado ou não.
---
## 🐛 Усунення несправностей
<details>
<summary><b>Натисніть, щоб розгорнути посібник з усунення несправностей</b></summary>
**"Мовна модель не надавала повідомлень"**
- Квота постачальника вичерпана → Перевірте систему відстеження квот на інформаційній панелі
- Рішення: скористайтеся комбінованим альтернативним варіантом або перейдіть на дешевший рівень
**Обмеження швидкості**
— Вичерпана квота на підписку → Повернення до GLM/MiniMax
- Додати комбо: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**Термін дії маркера OAuth минув**
— Автоматично оновлено OmniRoute
- Якщо проблеми не зникають: Інформаційна панель → Постачальник → Повторне підключення
**Високі витрати**
- Перевірте статистику використання в Інформаційній панелі → Витрати
- Переключіть основну модель на GLM/MiniMax
- Використовуйте безкоштовний рівень (Gemini CLI, iFlow) для некритичних завдань
**Інформаційна панель відкривається через неправильний порт**
- Встановити `PORT=20128` та `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Помилки хмарної синхронізації**
- Переконайтеся, що `BASE_URL` вказує на ваш запущений екземпляр
- Перевірте `CLOUD_URL` вказує на очікувану кінцеву точку хмари
- Зберігайте значення `NEXT_PUBLIC_*` у відповідності зі значеннями на стороні сервера
**Перший вхід не працює**
- Перевірте `INITIAL_PASSWORD` в `.env`
- Якщо не встановлено, резервний пароль `123456`
**Немає журналів запитів**
- Установіть `ENABLE_REQUEST_LOGS=true` в `.env`
**Тест з’єднання показує «Недійсне» для OpenAI-сумісних постачальників**
- Багато постачальників не розкривають кінцеву точку `/models`
- OmniRoute v1.0.6+ включає резервну перевірку через завершення чату
- Переконайтеся, що базова URL-адреса містить суфікс `/v1`
</details>
---
@@ -1178,85 +1106,6 @@ gh release create v1.0.6 --title "v1.0.6" --generate-notes
---
---
## 🇧🇷 OmniRoute — Gateway de IA Gratuito
<a name="-omniroute--gateway-de-ia-gratuito"></a>
### Nunca pare de codar. Roteamento inteligente para **modelos de IA GRATUITOS e de baixo custo** com reserve automático.
_Універсальний проксі-сервер API — кінцева точка, 36+ постачальників, нуль простоїв._
### 🌐 Internacionalização (i18n)
Інформаційна панель OmniRoute підтримує **багато ідіом**. Актуально доступні:
| Ідіома | Código | Статус |
| ----------------------- | ------- | -------- |
| 🇺🇸 англійська | `en` | ✅ Повне |
| 🇧🇷 Português (Бразилія) | `pt-BR` | ✅ Повне |
**Параметр троакар або ідіома:** Натисніть без вибору ідіоми (🇺🇸 EN) без заголовка на інформаційній панелі → вибір ідіоми.
**Para adicionar um nova idioma:**
1. Викличте `src/i18n/messages/{codigo}.json` на основі `en.json`
2. Додайте код `src/i18n/config.ts``LOCALES` і `LANGUAGES`
3. Reinicie або сервер
### ⚡ Início Rápido
```bash
# Instalar via npm
npx omniroute@latest
# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
```
### 🐳 Докер
```bash
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
```
### 🔑 Funcionalidades Principais
- **36+ провідників IA** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek та ін.
- **Roteamento inteligente** — Запасні автоматичні постачальники
- **Tradução de formato** — OpenAI ↔ Claude ↔ Gemini automaticamente
- **Multi-conta** — Múltiplas contas por provedor com seleção inteligente
- **Cache semântico** — Зменшити налаштування та затримку
- **OAuth automático** — автоматичне оновлення токенів
- **Combos personalizados** — 6 estratégias de roteamento
- **Помна панель приладів** — Моніторинг, журнали, аналізи, конфігурації
- **Інструменти CLI** — налаштуйте Claude Code, Codex, Cursor, Cline за допомогою кліка
- **100% TypeScript** — Código limpo e tipado
### 📖 Documentação
| Documento | Опис |
| ----------------------------------------------- | ------------------------------------- |
| [Guia do Usuário](docs/USER_GUIDE.md) | Провідори, комбо, CLI, розгортання |
| [Referência da API](docs/API_REFERENCE.md) | Усі кінцеві точки з прикладами |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Problemas comuns e soluções |
| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura e internos do sistema |
| [Contribuição](CONTRIBUTING.md) | Setup de desenvolvimento e guidelines |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Повна версія: VM + nginx + Cloudflare |
### 📧 Підтримуйте
> 💬 **Entre para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Тир dúvidas, compartilhe dicas e fique atualizado.
- **Веб-сайт**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Проблеми**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
---
<div align="center">
<sub>Створено з ❤️ для розробників, які працюють у режимі 24/7</sub>
<br/>

View File

@@ -3,8 +3,6 @@
# 🚀 OmniRoute — Cổng AI miễn phí
🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
### Không bao giờ ngừng viết mã. Định tuyến thông minh tới **Mô hình AI MIỄN PHÍ và chi phí thấp** với tính năng dự phòng tự động.
_Proxy API phổ quát của bạn — một điểm cuối, hơn 36 nhà cung cấp, không có thời gian ngừng hoạt động._
@@ -298,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 Trường hợp sử dụng
### Trường hợp 1: "Tôi có đăng ký Claude Pro"
**Vấn đề:** Hạn ngạch hết hạn không được sử dụng, giới hạn tốc độ trong quá trình mã hóa nặng
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Trường hợp 2: "Tôi muốn chi phí bằng 0"
**Vấn đề:** Không đủ khả năng đăng ký, cần mã hóa AI đáng tin cậy
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Trường hợp 3: "Tôi cần code 24/7, không bị gián đoạn"
**Vấn đề:** Thời hạn, không đủ khả năng cho thời gian ngừng hoạt động
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Trường hợp 4: "Tôi muốn AI MIỄN PHÍ trong OpenClaw"
**Vấn đề:** Cần trợ lý AI trong ứng dụng nhắn tin, hoàn toàn miễn phí
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 💡 Tính năng chính
### 🧠 Định tuyến lõi & thông minh
@@ -519,6 +456,67 @@ OmniRoute bao gồm Sân chơi dịch thuật tích hợp mạnh mẽ với **4
---
## 🎯 Trường hợp sử dụng
### Trường hợp 1: "Tôi có đăng ký Claude Pro"
**Vấn đề:** Hạn ngạch hết hạn không được sử dụng, giới hạn tốc độ trong quá trình mã hóa nặng
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (use subscription fully)
2. glm/glm-4.7 (cheap backup when quota out)
3. if/kimi-k2-thinking (free emergency fallback)
Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration
```
### Trường hợp 2: "Tôi muốn chi phí bằng 0"
**Vấn đề:** Không đủ khả năng đăng ký, cần mã hóa AI đáng tin cậy
```
Combo: "free-forever"
1. gc/gemini-3-flash (180K free/month)
2. if/kimi-k2-thinking (unlimited free)
3. qw/qwen3-coder-plus (unlimited free)
Monthly cost: $0
Quality: Production-ready models
```
### Trường hợp 3: "Tôi cần code 24/7, không bị gián đoạn"
**Vấn đề:** Thời hạn, không đủ khả năng cho thời gian ngừng hoạt động
```
Combo: "always-on"
1. cc/claude-opus-4-6 (best quality)
2. cx/gpt-5.2-codex (second subscription)
3. glm/glm-4.7 (cheap, resets daily)
4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
5. if/kimi-k2-thinking (free unlimited)
Result: 5 layers of fallback = zero downtime
```
### Trường hợp 4: "Tôi muốn AI MIỄN PHÍ trong OpenClaw"
**Vấn đề:** Cần trợ lý AI trong ứng dụng nhắn tin, hoàn toàn miễn phí
```
Combo: "openclaw-free"
1. if/glm-4.7 (unlimited free)
2. if/minimax-m2.1 (unlimited free)
3. if/kimi-k2-thinking (unlimited free)
Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
```
---
## 📖 Hướng dẫn thiết lập
<details>
@@ -799,74 +797,6 @@ Settings → API Configuration:
---
## 📊 Mẫu có sẵn
<details>
<summary><b>Xem tất cả các mẫu có sẵn</b></summary>
**Mã Claude (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Codex (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - MIỄN PHÍ:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**Phi công phụ GitHub (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - Tín dụng MIỄN PHÍ:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- Hơn 50 mẫu khác trên [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - 0,6 USD/1 triệu:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - 0,2 USD/1 triệu:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - MIỄN PHÍ:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - MIỄN PHÍ:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - MIỄN PHÍ:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - Hơn 100 mẫu:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- Bất kỳ mẫu nào từ [openrouter.ai/models](https://openrouter.ai/models)
</details>
---
## 🧪 Đánh giá (Evals)
OmniRoute bao gồm khung đánh giá tích hợp để kiểm tra chất lượng phản hồi LLM dựa trên bộ vàng. Truy cập thông qua **Analytics → Đánh giá** trong bảng điều khiển.
@@ -890,7 +820,58 @@ OmniRoute bao gồm khung đánh giá tích hợp để kiểm tra chất lượ
---
## 🔐 OAuth trên Servidor Remoto (Thiết lập OAuth từ xa)
## 🐛 Khắc phục sự cố
<details>
<summary><b>Nhấp để mở rộng hướng dẫn khắc phục sự cố</b></summary>
**"Mô hình ngôn ngữ không cung cấp tin nhắn"**
- Đã hết hạn ngạch nhà cung cấp → Kiểm tra trình theo dõi hạn ngạch bảng điều khiển
- Giải pháp: Sử dụng combo dự phòng hoặc chuyển sang tầng rẻ hơn
**Giới hạn tỷ lệ**
- Hết hạn ngạch đăng ký → Dự phòng sang GLM/MiniMax
- Thêm tổ hợp: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**Mã thông báo OAuth đã hết hạn**
- Tự động làm mới bởi OmniRoute
- Nếu sự cố vẫn tiếp diễn: Bảng điều khiển → Nhà cung cấp → Kết nối lại
**Chi phí cao**
- Kiểm tra số liệu thống kê sử dụng trong Bảng điều khiển → Chi phí
- Chuyển mô hình chính sang GLM/MiniMax
- Sử dụng bậc miễn phí (Gemini CLI, iFlow) cho các tác vụ không quan trọng
**Bảng điều khiển mở sai cổng**
- Đặt `PORT=20128``NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Lỗi đồng bộ hóa đám mây**
- Xác minh `BASE_URL` trỏ tới phiên bản đang chạy của bạn
- Xác minh `CLOUD_URL` điểm tới điểm cuối đám mây dự kiến của bạn
- Giữ các giá trị `NEXT_PUBLIC_*` được căn chỉnh với các giá trị phía máy chủ
**Đăng nhập lần đầu không hoạt động**
- Kiểm tra `INITIAL_PASSWORD` trong `.env`
- Nếu không được đặt, mật khẩu dự phòng là `123456`
**Không có nhật ký yêu cầu**
- Đặt `ENABLE_REQUEST_LOGS=true` trong `.env`
**Kiểm tra kết nối cho thấy "Không hợp lệ" đối với các nhà cung cấp tương thích với OpenAI**
- Nhiều nhà cung cấp không hiển thị điểm cuối `/models`
- OmniRoute v1.0.6+ bao gồm xác thực dự phòng thông qua hoàn thành trò chuyện
- Đảm bảo URL cơ sở bao gồm hậu tố `/v1`
### 🔐 OAuth trên Servidor Remoto (Thiết lập OAuth từ xa)
<a name="oauth-em-servidor-remoto"></a>
@@ -981,59 +962,6 @@ Nếu không có câu hỏi nào về thông tin xác thực trước đây, b
> Chức năng giải pháp này có thể giúp tự động cấp quyền cho URL và có thể chuyển hướng độc lập đến mục tiêu hoặc không.
---
## 🐛 Khắc phục sự cố
<details>
<summary><b>Nhấp để mở rộng hướng dẫn khắc phục sự cố</b></summary>
**"Mô hình ngôn ngữ không cung cấp tin nhắn"**
- Đã hết hạn ngạch nhà cung cấp → Kiểm tra trình theo dõi hạn ngạch bảng điều khiển
- Giải pháp: Sử dụng combo dự phòng hoặc chuyển sang tầng rẻ hơn
**Giới hạn tỷ lệ**
- Hết hạn ngạch đăng ký → Dự phòng sang GLM/MiniMax
- Thêm tổ hợp: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
**Mã thông báo OAuth đã hết hạn**
- Tự động làm mới bởi OmniRoute
- Nếu sự cố vẫn tiếp diễn: Bảng điều khiển → Nhà cung cấp → Kết nối lại
**Chi phí cao**
- Kiểm tra số liệu thống kê sử dụng trong Bảng điều khiển → Chi phí
- Chuyển mô hình chính sang GLM/MiniMax
- Sử dụng bậc miễn phí (Gemini CLI, iFlow) cho các tác vụ không quan trọng
**Bảng điều khiển mở sai cổng**
- Đặt `PORT=20128``NEXT_PUBLIC_BASE_URL=http://localhost:20128`
**Lỗi đồng bộ hóa đám mây**
- Xác minh `BASE_URL` trỏ tới phiên bản đang chạy của bạn
- Xác minh `CLOUD_URL` điểm tới điểm cuối đám mây dự kiến của bạn
- Giữ các giá trị `NEXT_PUBLIC_*` được căn chỉnh với các giá trị phía máy chủ
**Đăng nhập lần đầu không hoạt động**
- Kiểm tra `INITIAL_PASSWORD` trong `.env`
- Nếu không được đặt, mật khẩu dự phòng là `123456`
**Không có nhật ký yêu cầu**
- Đặt `ENABLE_REQUEST_LOGS=true` trong `.env`
**Kiểm tra kết nối cho thấy "Không hợp lệ" đối với các nhà cung cấp tương thích với OpenAI**
- Nhiều nhà cung cấp không hiển thị điểm cuối `/models`
- OmniRoute v1.0.6+ bao gồm xác thực dự phòng thông qua hoàn thành trò chuyện
- Đảm bảo URL cơ sở bao gồm hậu tố `/v1`
</details>
---
@@ -1176,85 +1104,6 @@ Giấy phép MIT - xem [LICENSE](LICENSE) để biết chi tiết.
---
---
## 🇧🇷 OmniRoute — Gateway de IA Gratuito
<a name="-omniroute--gateway-de-ia-gratuito"></a>
### Nunca pare de codar. Roteamento thông minh cho **mô hình IA MIỄN PHÍ và baixo tùy chỉnh** và tự động dự phòng.
_Seu proxy phổ quát de API — ừm điểm cuối, hơn 36 điểm đã được chứng minh, không có thời gian ngừng hoạt động._
### 🌐 Quốc tế hóa (i18n)
O bảng điều khiển hỗ trợ OmniRoute **nhiều thành ngữ**. Cuối cùng, bạn có thể giải quyết:
| Thành ngữ | Código | Trạng thái |
| --------------------- | ------- | ------------- |
| 🇺🇸 Tiếng Anh | `en` | ✅ Hoàn thiện |
| 🇧🇷 Português (Brasil) | `pt-BR` | ✅ Hoàn thiện |
**Para trocar o thành ngữ:** Clique no seletor de Idi chỉ (🇺🇸 EN) không có tiêu đề làm bảng điều khiển → chọn lựa hoặc thành ngữ desejado.
**Thêm một thành ngữ mới:**
1. Khóc `src/i18n/messages/{codigo}.json` dựa trên `en.json`
2. Adicione hoặc código em `src/i18n/config.ts``LOCALES` e `LANGUAGES`
3. Phục hồi hoặc phục vụ
### ⚡ Início Rápido
```bash
# Instalar via npm
npx omniroute@latest
# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
```
### 🐳 Docker
```bash
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
```
### 🔑 Chức năng chính
- **36+ chứng minh của IA** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek, và nhiều hơn nữa
- **Roteamento inteligente** — Tự động dự phòng trong các phương pháp được chứng minh
- **Giao dịch định dạng** — OpenAI ↔ Claude ↔ Gemini tự động
- **Multi-conta** — Nhiều conta được chứng minh bằng cách lựa chọn thông minh
- **Cache semântico** — Reduz custos và latência
- **Tự động OAuth** — Tự động đổi mới mã thông báo
- **Combo cá nhân hóa** — 6 chiến lược roteamento
- **Hoàn thành bảng điều khiển** — Màn hình, nhật ký, phân tích, cấu hình
- **Công cụ CLI** — Định cấu hình Mã Claude, Codex, Con trỏ, Cline với một nhóm
- **100% TypeScript** — Código limbo e tipado
### 📖 Tài liệu
| Tài liệu | Mô tả |
| ----------------------------------------------- | --------------------------------------------------- |
| [Guia do Usuário](docs/USER_GUIDE.md) | Provedores, combo, CLI, triển khai |
| [Referência da API](docs/API_REFERENCE.md) | Tất cả các điểm cuối của hệ điều hành như các ví dụ |
| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Các vấn đề công cộng và giải pháp |
| [Arquitetura](docs/ARCHITECTURE.md) | Hệ thống Arquitetura và internos |
| [Contribuição](CONTRIBUTING.md) | Thiết lập các nguyên tắc phát triển |
| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Hướng dẫn hoàn chỉnh: VM + nginx + Cloudflare |
### 📧 Hỗ trợ
> 💬 **Entre para a communidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tyre duvidas, compartilhe dicas and fique atualizado.
- **Trang web**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Vấn đề**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
---
<div align="center">
<sub>Được xây dựng với ❤️ dành cho nhà phát triển viết mã 24/7</sub>
<br/>

View File

@@ -296,67 +296,6 @@ npm run electron:build:linux # Linux (.AppImage)
---
## 🎯 使用场景
### 场景 1"我有 Claude Pro 订阅"
**问题:** 配额未使用就过期,编程高峰期遇到速率限制
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (充分使用订阅)
2. glm/glm-4.7 (配额用完时的便宜备用)
3. if/kimi-k2-thinking (免费应急后备)
每月成本:$20订阅+ ~$5备用= $25 总计
对比:$20 + 遇到限制 = 受挫
```
### 场景 2"我想要零成本"
**问题:** 无法承担订阅费用,需要可靠的 AI 编程
```
Combo: "free-forever"
1. gc/gemini-3-flash (每月 180K 免费)
2. if/kimi-k2-thinking (无限免费)
3. qw/qwen3-coder-plus (无限免费)
每月成本:$0
质量:生产级模型
```
### 场景 3"我需要 24/7 编程,不中断"
**问题:** 截止日期紧迫,不能有停机时间
```
Combo: "always-on"
1. cc/claude-opus-4-6 (最佳质量)
2. cx/gpt-5.2-codex (第二个订阅)
3. glm/glm-4.7 (便宜,每日重置)
4. minimax/MiniMax-M2.1 最便宜5小时重置
5. if/kimi-k2-thinking (免费无限制)
结果5 层故障转移 = 零停机
```
### 场景 4"我想在 OpenClaw 中使用免费 AI"
**问题:** 需要在消息应用中使用 AI 助手,完全免费
```
Combo: "openclaw-free"
1. if/glm-4.7 (无限免费)
2. if/minimax-m2.1 (无限免费)
3. if/kimi-k2-thinking (无限免费)
每月成本:$0
访问方式WhatsApp、Telegram、Slack、Discord、iMessage、Signal...
```
---
## 💡 核心功能
### 🧠 路由与智能
@@ -498,6 +437,67 @@ Combo: "my-coding-stack"
---
## 🎯 使用场景
### 场景 1"我有 Claude Pro 订阅"
**问题:** 配额未使用就过期,编程高峰期遇到速率限制
```
Combo: "maximize-claude"
1. cc/claude-opus-4-6 (充分使用订阅)
2. glm/glm-4.7 (配额用完时的便宜备用)
3. if/kimi-k2-thinking (免费应急后备)
每月成本:$20订阅+ ~$5备用= $25 总计
对比:$20 + 遇到限制 = 受挫
```
### 场景 2"我想要零成本"
**问题:** 无法承担订阅费用,需要可靠的 AI 编程
```
Combo: "free-forever"
1. gc/gemini-3-flash (每月 180K 免费)
2. if/kimi-k2-thinking (无限免费)
3. qw/qwen3-coder-plus (无限免费)
每月成本:$0
质量:生产级模型
```
### 场景 3"我需要 24/7 编程,不中断"
**问题:** 截止日期紧迫,不能有停机时间
```
Combo: "always-on"
1. cc/claude-opus-4-6 (最佳质量)
2. cx/gpt-5.2-codex (第二个订阅)
3. glm/glm-4.7 (便宜,每日重置)
4. minimax/MiniMax-M2.1 最便宜5小时重置
5. if/kimi-k2-thinking (免费无限制)
结果5 层故障转移 = 零停机
```
### 场景 4"我想在 OpenClaw 中使用免费 AI"
**问题:** 需要在消息应用中使用 AI 助手,完全免费
```
Combo: "openclaw-free"
1. if/glm-4.7 (无限免费)
2. if/minimax-m2.1 (无限免费)
3. if/kimi-k2-thinking (无限免费)
每月成本:$0
访问方式WhatsApp、Telegram、Slack、Discord、iMessage、Signal...
```
---
## 📖 设置指南
<details>
@@ -778,74 +778,6 @@ codex "your prompt"
---
## 📊 可用模型
<details>
<summary><b>查看所有可用模型</b></summary>
**Claude Code (`cc/`)** - Pro/Max:
- `cc/claude-opus-4-6`
- `cc/claude-sonnet-4-5-20250929`
- `cc/claude-haiku-4-5-20251001`
**Codex (`cx/`)** - Plus/Pro:
- `cx/gpt-5.2-codex`
- `cx/gpt-5.1-codex-max`
**Gemini CLI (`gc/`)** - 免费:
- `gc/gemini-3-flash-preview`
- `gc/gemini-2.5-pro`
**GitHub Copilot (`gh/`)**:
- `gh/gpt-5`
- `gh/claude-4.5-sonnet`
**NVIDIA NIM (`nvidia/`)** - 免费积分:
- `nvidia/llama-3.3-70b-instruct`
- `nvidia/mistral-7b-instruct`
- 50+ 更多模型在 [build.nvidia.com](https://build.nvidia.com)
**GLM (`glm/`)** - $0.6/1M:
- `glm/glm-4.7`
**MiniMax (`minimax/`)** - $0.2/1M:
- `minimax/MiniMax-M2.1`
**iFlow (`if/`)** - 免费:
- `if/kimi-k2-thinking`
- `if/qwen3-coder-plus`
- `if/deepseek-r1`
- `if/glm-4.7`
- `if/minimax-m2`
**Qwen (`qw/`)** - 免费:
- `qw/qwen3-coder-plus`
- `qw/qwen3-coder-flash`
**Kiro (`kr/`)** - 免费:
- `kr/claude-sonnet-4.5`
- `kr/claude-haiku-4.5`
**OpenRouter (`or/`)** - 100+ 模型:
- `or/anthropic/claude-4-sonnet`
- `or/google/gemini-2.5-pro`
- [openrouter.ai/models](https://openrouter.ai/models) 上的任何模型
</details>
---
## 🧪 评估 (Evals)
OmniRoute 包含内置评估框架,用于针对黄金集测试 LLM 响应质量。通过仪表板中的 **Analytics → Evals** 访问。

28
package-lock.json generated
View File

@@ -1,12 +1,12 @@
{
"name": "omniroute",
"version": "1.6.3",
"version": "1.6.4",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "omniroute",
"version": "1.6.3",
"version": "1.6.4",
"hasInstallScript": true,
"license": "MIT",
"workspaces": [
@@ -2345,7 +2345,7 @@
"version": "1.58.2",
"resolved": "https://registry.npmjs.org/@playwright/test/-/test-1.58.2.tgz",
"integrity": "sha512-akea+6bHYBBfA9uQqSYmlJXn61cTa+jbO87xVLCWbTqbWadRVmhxlXATaOjOgcBaWU4ePo0wB41KMFv3o35IXA==",
"dev": true,
"devOptional": true,
"license": "Apache-2.0",
"dependencies": {
"playwright": "1.58.2"
@@ -3075,7 +3075,7 @@
"version": "19.2.14",
"resolved": "https://registry.npmjs.org/@types/react/-/react-19.2.14.tgz",
"integrity": "sha512-ilcTH/UniCkMdtexkoCN0bI7pMcJDvmQFPvuPvmEaYA/NSfFTAgdUSLAoVjaRJm7+6PvcM+q1zYOwS4wTYMF9w==",
"dev": true,
"devOptional": true,
"license": "MIT",
"dependencies": {
"csstype": "^3.2.2"
@@ -4698,7 +4698,7 @@
"version": "3.2.3",
"resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz",
"integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==",
"dev": true,
"devOptional": true,
"license": "MIT"
},
"node_modules/d3-array": {
@@ -8282,6 +8282,17 @@
}
}
},
"node_modules/next-intl/node_modules/@swc/helpers": {
"version": "0.5.19",
"resolved": "https://registry.npmjs.org/@swc/helpers/-/helpers-0.5.19.tgz",
"integrity": "sha512-QamiFeIK3txNjgUTNppE6MiG3p7TdninpZu0E0PbqVh1a9FNLT2FRhisaa4NcaX52XVhA5l7Pk58Ft7Sqi/2sA==",
"license": "Apache-2.0",
"optional": true,
"peer": true,
"dependencies": {
"tslib": "^2.8.0"
}
},
"node_modules/next/node_modules/postcss": {
"version": "8.4.31",
"resolved": "https://registry.npmjs.org/postcss/-/postcss-8.4.31.tgz",
@@ -8826,7 +8837,7 @@
"version": "1.58.2",
"resolved": "https://registry.npmjs.org/playwright/-/playwright-1.58.2.tgz",
"integrity": "sha512-vA30H8Nvkq/cPBnNw4Q8TWz1EJyqgpuinBcHET0YVJVFldr8JDNiU9LaWAE1KqSkRYazuaBhTpB5ZzShOezQ6A==",
"dev": true,
"devOptional": true,
"license": "Apache-2.0",
"dependencies": {
"playwright-core": "1.58.2"
@@ -8845,7 +8856,7 @@
"version": "1.58.2",
"resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.58.2.tgz",
"integrity": "sha512-yZkEtftgwS8CsfYo7nm0KE8jsvm6i/PTgVtB8DL726wNf6H2IMsDuxCpJj59KDaxCtSnrWan2AeDqM7JBaultg==",
"dev": true,
"devOptional": true,
"license": "Apache-2.0",
"bin": {
"playwright-core": "cli.js"
@@ -9164,7 +9175,6 @@
"version": "16.13.1",
"resolved": "https://registry.npmjs.org/react-is/-/react-is-16.13.1.tgz",
"integrity": "sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==",
"dev": true,
"license": "MIT"
},
"node_modules/react-redux": {
@@ -10659,7 +10669,7 @@
"version": "5.9.3",
"resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
"integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
"dev": true,
"devOptional": true,
"license": "Apache-2.0",
"bin": {
"tsc": "bin/tsc",