diff --git a/README.ar.md b/README.ar.md index d481b53c52..6083671654 100644 --- a/README.ar.md +++ b/README.ar.md @@ -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... +``` + +--- + ## 📖 دليل الإعداد
@@ -796,74 +796,6 @@ Settings → API Configuration: --- -## 📊 الموديلات المتوفرة - -
-عرض جميع الموديلات المتاحة - -**كود كلود (`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) - -
- ---- - ## 🧪 التقييمات (التقييمات) يشتمل OmniRoute على إطار تقييم مدمج لاختبار جودة استجابة LLM مقابل المجموعة الذهبية. يمكنك الوصول إليه عبر **Analytics → Evals** في لوحة التحكم. @@ -887,7 +819,58 @@ Settings → API Configuration: --- -## 🔐 OAuth em Servidor Remoto (إعداد OAuth عن بعد) +## 🐛 استكشاف الأخطاء وإصلاحها + +
+انقر لتوسيع دليل استكشاف الأخطاء وإصلاحها + +**"نموذج اللغة لم يقدم رسائل"** + +- استنفدت حصة الموفر → تحقق من تعقب حصة الموفر في لوحة المعلومات +- الحل: استخدم خيار التحرير والسرد الاحتياطي أو قم بالتبديل إلى مستوى أرخص + +** الحد من المعدل ** + +- حصة الاشتراك المحددة → الرجوع إلى 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 عن بعد) @@ -978,59 +961,6 @@ Agora o Google redirecionará corretamente para `https://seu-servidor.com/callba > يعمل هذا الحل البديل لأن رمز التفويض الموجود على عنوان URL يكون صالحًا بشكل مستقل لإعادة التوجيه حيث يتم تحميله أو لا. ---- - -## 🐛 استكشاف الأخطاء وإصلاحها - -
-انقر لتوسيع دليل استكشاف الأخطاء وإصلاحها - -**"نموذج اللغة لم يقدم رسائل"** - -- استنفدت حصة الموفر → تحقق من تعقب حصة الموفر في لوحة المعلومات -- الحل: استخدم خيار التحرير والسرد الاحتياطي أو قم بالتبديل إلى مستوى أرخص - -** الحد من المعدل ** - -- حصة الاشتراك المحددة → الرجوع إلى 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` -
--- diff --git a/README.bg.md b/README.bg.md index 60ef479955..088c36636f 100644 --- a/README.bg.md +++ b/README.bg.md @@ -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... +``` + +--- + ## 📖 Ръководство за настройка
@@ -799,74 +797,6 @@ Settings → API Configuration: --- -## 📊 Налични модели - -
-Вижте всички налични модели - -**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) - -
- ---- - ## 🧪 Оценки (Evals) OmniRoute включва вградена рамка за оценка за тестване на качеството на отговора на LLM спрямо златен набор. Достъп до него чрез **Analytics → Evals** в таблото за управление. @@ -890,7 +820,58 @@ OmniRoute включва вградена рамка за оценка за те --- -## 🔐 OAuth em Servidor Remoto (Отдалечена настройка на OAuth) +## 🐛 Отстраняване на неизправности + +
+Щракнете, за да разширите ръководството за отстраняване на неизправности + +**„Езиковият модел не предостави съобщения“** + +- Квотата на доставчика е изчерпана → Проверете инструмента за проследяване на квотата на таблото за управление +- Решение: Използвайте комбо резервен вариант или преминете към по-евтино ниво + +**Ограничаване на скоростта** + +- Изчерпване на квотата за абонамент → Резервно връщане към 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) @@ -981,59 +962,6 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux > Това заобиколно решение функционира, ако кодът на авторизацията на URL е валиден независимо от пренасочването към пренасочване или не. ---- - -## 🐛 Отстраняване на неизправности - -
-Щракнете, за да разширите ръководството за отстраняване на неизправности - -**„Езиковият модел не предостави съобщения“** - -- Квотата на доставчика е изчерпана → Проверете инструмента за проследяване на квотата на таблото за управление -- Решение: Използвайте комбо резервен вариант или преминете към по-евтино ниво - -**Ограничаване на скоростта** - -- Изчерпване на квотата за абонамент → Резервно връщане към 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` -
--- @@ -1176,85 +1104,6 @@ gh release create v1.0.6 --title "v1.0.6" --generate-notes --- ---- - -## 🇧🇷 OmniRoute — Gateway de IA Gratuito - - - -### 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) - ---- -
Създаден с ❤️ за разработчици, които кодират 24/7
diff --git a/README.da.md b/README.da.md index c4b03a7879..3cb4f044b2 100644 --- a/README.da.md +++ b/README.da.md @@ -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
@@ -799,74 +797,6 @@ Settings → API Configuration: --- -## 📊 Tilgængelige modeller - -
-Se alle tilgængelige modeller - -**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) - -
- ---- - ## 🧪 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 + +
+Klik for at udvide fejlfindingsvejledning + +**"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) @@ -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 - -
-Klik for at udvide fejlfindingsvejledning - -**"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` -
--- @@ -1176,85 +1104,6 @@ MIT-licens - se [LICENSE](LICENSE) for detaljer. --- ---- - -## 🇧🇷 OmniRoute — Gateway de IA Gratis - - - -### 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) - ---- -
Bygget med ❤️ for udviklere, der koder 24/7
diff --git a/README.de.md b/README.de.md index 5d97553eb8..86bd560caf 100644 --- a/README.de.md +++ b/README.de.md @@ -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
@@ -778,74 +778,6 @@ Einstellungen → API-Konfiguration: --- -## 📊 Verfügbare Modelle - -
-Alle verfügbaren Modelle anzeigen - -**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) - -
- ---- - ## 🧪 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. diff --git a/README.es.md b/README.es.md index 43807b9a6b..2835186603 100644 --- a/README.es.md +++ b/README.es.md @@ -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
@@ -782,74 +782,6 @@ Configuración → Configuración de API: --- -## 📊 Modelos Disponibles - -
-Ver todos los modelos disponibles - -**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) - -
- ---- - ## 🧪 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. diff --git a/README.fi.md b/README.fi.md index 4a5e8ec99c..2213f3ef1e 100644 --- a/README.fi.md +++ b/README.fi.md @@ -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
@@ -799,74 +797,6 @@ Settings → API Configuration: --- -## 📊 Saatavilla olevat mallit - -
-Näytä kaikki saatavilla olevat mallit - -**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) - -
- ---- - ## 🧪 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ä + +
+Laajenna vianetsintäopas napsauttamalla + +**"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) @@ -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ä - -
-Laajenna vianetsintäopas napsauttamalla - -**"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 -
--- @@ -1176,85 +1104,6 @@ MIT-lisenssi – katso lisätietoja osoitteesta [LICENSE](LICENSE). --- ---- - -## 🇧🇷 OmniRoute — Gateway de IA Gratuito - - - -### 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) - ---- -
Rakennettu ❤️-kehittäjille, jotka koodaavat 24/7
diff --git a/README.fr.md b/README.fr.md index e9e4ff7fc5..2cf1d668b1 100644 --- a/README.fr.md +++ b/README.fr.md @@ -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
@@ -780,74 +780,6 @@ Paramètres → Configuration API : --- -## 📊 Modèles disponibles - -
-Voir tous les modèles disponibles - -**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) - -
- ---- - ## 🧪 É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. diff --git a/README.he.md b/README.he.md index ac126868b8..8f0cef2197 100644 --- a/README.he.md +++ b/README.he.md @@ -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... +``` + +--- + ## 📖 מדריך התקנה
@@ -799,74 +797,6 @@ Settings → API Configuration: --- -## 📊 דגמים זמינים - -
-הצג את כל הדגמים הזמינים - -**קוד קלוד (`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) - -
- ---- - ## 🧪 הערכות (הערכות) OmniRoute כולל מסגרת הערכה מובנית לבדיקת איכות תגובת LLM מול סט מוזהב. גש אליו דרך **Analytics → Evals** בלוח המחוונים. @@ -890,7 +820,58 @@ OmniRoute כולל מסגרת הערכה מובנית לבדיקת איכות ת --- -## 🔐 OAuth em Servidor Remoto (הגדרת OAuth מרחוק) +## 🐛 פתרון בעיות + +
+לחץ כדי להרחיב את המדריך לפתרון בעיות + +**"מודל השפה לא סיפק הודעות"** + +- מיצתה מכסת הספק ← בדוק את עוקב המכסות של לוח המחוונים +- פתרון: השתמש ב-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 מרחוק) @@ -981,59 +962,6 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux > פתרון עקיפת הבעיה או קוד אוטומטי של כתובת ה-URL או עצמאית להפנות את החשבון או לא. ---- - -## 🐛 פתרון בעיות - -
-לחץ כדי להרחיב את המדריך לפתרון בעיות - -**"מודל השפה לא סיפק הודעות"** - -- מיצתה מכסת הספק ← בדוק את עוקב המכסות של לוח המחוונים -- פתרון: השתמש ב-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` -
--- @@ -1176,85 +1104,6 @@ gh release create v1.0.6 --title "v1.0.6" --generate-notes --- ---- - -## 🇧🇷 OmniRoute — Gateway de IA Gratuito - - - -### 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) - ---- -
נבנה עם ❤️ למפתחים שמקודדים 24/7
diff --git a/README.hu.md b/README.hu.md index 61ee5ccf8e..013087e2da 100644 --- a/README.hu.md +++ b/README.hu.md @@ -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ó
@@ -799,74 +797,6 @@ Settings → API Configuration: --- -## 📊 Elérhető modellek - -
-Az összes elérhető modell megtekintése - -**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 - -
- ---- - ## 🧪 É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 + +
+Kattintson a hibaelhárítási útmutató kibontásához + +**"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) @@ -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 - -
-Kattintson a hibaelhárítási útmutató kibontásához - -**"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 -
--- @@ -1176,85 +1104,6 @@ MIT-licenc – a részletekért lásd: [LICENSE](LICENSE). --- ---- - -## 🇧🇷 OmniRoute — IA ingyenes átjáró - - - -### 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) - ---- -
A ❤️ segítségével készült a 24/7 kódoló fejlesztőknek
diff --git a/README.id.md b/README.id.md index fc4928b9b3..342496d244 100644 --- a/README.id.md +++ b/README.id.md @@ -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
@@ -799,74 +797,6 @@ Settings → API Configuration: --- -## 📊 Model yang Tersedia - -
-Lihat semua model yang tersedia - -**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) - -
- ---- - ## 🧪 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 + +
+Klik untuk memperluas panduan pemecahan masalah + +**"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) @@ -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 - -
-Klik untuk memperluas panduan pemecahan masalah - -**"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` -
--- @@ -1176,85 +1104,6 @@ Lisensi MIT - lihat [LICENSE](LICENSE) untuk detailnya. --- ---- - -## 🇧🇷 OmniRoute — Gerbang IA Gratis - - - -### 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) - ---- -
Dibangun dengan ❤️ untuk pengembang yang membuat kode 24/7
diff --git a/README.in.md b/README.in.md index d091eb4b1c..71ff9c3341 100644 --- a/README.in.md +++ b/README.in.md @@ -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... +``` + +--- + ## 📖 सेटअप गाइड 💳 सदस्यता प्रदाता @@ -616,95 +616,6 @@ Cost: $0 forever! --- -## 🔐 OAuth em सर्विडोर रेमोटो (रिमोट OAuth सेटअप) - - - -> **⚠️ वीपीएस/डॉकर/सर्विडोर रिमोट पर ओमनीरूट का उपयोग करने के लिए महत्वपूर्ण** - -### क्या आप एंटीग्रेविटी/जेमिनी सीएलआई के लिए 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. उन्हें क्लिक करें **"कनेक्ट"** - -> यह समाधान यूआरएल को स्वचालित रूप से डाउनलोड करने के लिए काम कर रहा है और आपके द्वारा किए गए रीडायरेक्ट को स्वतंत्र रूप से वैध बनाता है। - ---- - ## 🐛 समस्या निवारण समस्या निवारण मार्गदर्शिका का विस्तार करने के लिए क्लिक करें diff --git a/README.it.md b/README.it.md index 93ac9014c8..464548591c 100644 --- a/README.it.md +++ b/README.it.md @@ -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
@@ -778,74 +778,6 @@ Impostazioni → Configurazione API: --- -## 📊 Modelli Disponibili - -
-Vedi tutti i modelli disponibili - -**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) - -
- ---- - ## 🧪 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. diff --git a/README.ja.md b/README.ja.md index 1d7b6ff6bf..468794cda4 100644 --- a/README.ja.md +++ b/README.ja.md @@ -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... +``` + +--- + ## 📖 セットアップガイド
@@ -796,74 +796,6 @@ Settings → API Configuration: --- -## 📊 利用可能なモデル - -
-利用可能なモデルをすべて表示 - -**クロード コード (`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) の任意のモデル - -
- ---- - ## 🧪 評価 (Evals) OmniRoute には、ゴールデン セットに対して LLM 応答品質をテストするための評価フレームワークが組み込まれています。ダッシュボードの **Analytics → Evals** からアクセスします。 @@ -887,7 +819,58 @@ OmniRoute には、ゴールデン セットに対して LLM 応答品質をテ --- -## 🔐 サーバーリモートの OAuth (リモート OAuth セットアップ) +## 🐛 トラブルシューティング + +
+クリックしてトラブルシューティング ガイドを展開 + +**「言語モデルがメッセージを提供しませんでした」** + +- プロバイダー クォータが枯渇した → ダッシュボード クォータ トラッカーを確認してください +- 解決策: コンボフォールバックを使用するか、より安価なレベルに切り替える + +**レート制限** + +- サブスクリプション クォータ アウト → 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 セットアップ) @@ -978,59 +961,6 @@ docker restart omniroute > 自動回避策の機能は URL から独立してリダイレクトされます。 ---- - -## 🐛 トラブルシューティング - -
-クリックしてトラブルシューティング ガイドを展開 - -**「言語モデルがメッセージを提供しませんでした」** - -- プロバイダー クォータが枯渇した → ダッシュボード クォータ トラッカーを確認してください -- 解決策: コンボフォールバックを使用するか、より安価なレベルに切り替える - -**レート制限** - -- サブスクリプション クォータ アウト → 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` サフィックスが含まれていることを確認してください -
--- diff --git a/README.ko.md b/README.ko.md index a4c0e94f8c..dc5cf43ded 100644 --- a/README.ko.md +++ b/README.ko.md @@ -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... +``` + +--- + ## 📖 설정 가이드
@@ -799,74 +797,6 @@ Settings → API Configuration: --- -## 📊 사용 가능한 모델 - -
-사용 가능한 모든 모델 보기 - -**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)의 모든 모델 - -
- ---- - ## 🧪 평가(Evals) OmniRoute에는 골든 세트에 대해 LLM 응답 품질을 테스트하기 위한 내장 평가 프레임워크가 포함되어 있습니다. 대시보드의 **분석 → 평가**를 통해 액세스하세요. @@ -890,7 +820,58 @@ OmniRoute에는 골든 세트에 대해 LLM 응답 품질을 테스트하기 위 --- -## 🔐 OAuth em Servidor Remoto(원격 OAuth 설정) +## 🐛 문제 해결 + +
+문제 해결 가이드를 확장하려면 클릭하세요 + +**"언어 모델이 메시지를 제공하지 않았습니다"** + +- 공급자 할당량 소진 → 대시보드 할당량 추적기 확인 +- 해결 방법: 콤보 폴백을 사용하거나 더 저렴한 계층으로 전환하세요. + +**비율 제한** + +- 구독 할당량 초과 → 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 설정) @@ -981,59 +962,6 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux > 이 해결 방법은 URL을 통해 자동으로 코드를 확인하거나 독립적으로 리디렉션할 수 있도록 하는 것입니다. ---- - -## 🐛 문제 해결 - -
-문제 해결 가이드를 확장하려면 클릭하세요 - -**"언어 모델이 메시지를 제공하지 않았습니다"** - -- 공급자 할당량 소진 → 대시보드 할당량 추적기 확인 -- 해결 방법: 콤보 폴백을 사용하거나 더 저렴한 계층으로 전환하세요. - -**비율 제한** - -- 구독 할당량 초과 → 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` 접미사가 포함되어 있는지 확인하세요. -
--- @@ -1176,85 +1104,6 @@ MIT 라이선스 - 자세한 내용은 [LICENSE](LICENSE)을 참조하세요. --- ---- - -## 🇧🇷 OmniRoute — IA 무료 게이트웨이 - - - -### 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) - ---- -
연중무휴을 코딩하는 개발자를 위해 ❤️으로 구축됨
diff --git a/README.md b/README.md index 8eb39776df..2f213a6100 100644 --- a/README.md +++ b/README.md @@ -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) + +
+ +--- + ### 🤖 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) - -
+- **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
@@ -822,74 +832,6 @@ Settings → API Configuration: --- -## 📊 Available Models - -
-View all available models - -**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) - -
- ---- - ## 🧪 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 + +
+Click to expand troubleshooting guide + +**"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) > **⚠️ 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 - -
-Click to expand troubleshooting guide - -**"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 -
--- @@ -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 - - - -### 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) - ---- -
Built with ❤️ for developers who code 24/7
diff --git a/README.ms.md b/README.ms.md index 24f925eb7b..25140dc535 100644 --- a/README.ms.md +++ b/README.ms.md @@ -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
@@ -799,74 +797,6 @@ Settings → API Configuration: --- -## 📊 Model Tersedia - -
-Lihat semua model yang tersedia - -**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) - -
- ---- - ## 🧪 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 + +
+Klik untuk mengembangkan panduan penyelesaian masalah + +**"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) @@ -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 - -
-Klik untuk mengembangkan panduan penyelesaian masalah - -**"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` -
--- @@ -1176,85 +1104,6 @@ Lesen MIT - lihat [LICENSE](LICENSE) untuk butiran. --- ---- - -## 🇧🇷 OmniRoute — Gateway de IA Gratuito - - - -### 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) - ---- -
Dibina dengan ❤️ untuk pembangun yang kod 24/7
diff --git a/README.nl.md b/README.nl.md index b08f1b65c0..ed17dbbd64 100644 --- a/README.nl.md +++ b/README.nl.md @@ -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
@@ -799,74 +797,6 @@ Settings → API Configuration: --- -## 📊 Beschikbare modellen - -
-Bekijk alle beschikbare modellen - -**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) - -
- ---- - ## 🧪 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 + +
+Klik om de probleemoplossingsgids uit te vouwen + +**"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) @@ -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 - -
-Klik om de probleemoplossingsgids uit te vouwen - -**"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 -
--- @@ -1176,85 +1104,6 @@ MIT-licentie - zie [LICENSE](LICENSE) voor details. --- ---- - -## 🇧🇷 OmniRoute — Gateway de IA Gratis - - - -### 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) - ---- -
Gebouwd met ❤️ voor ontwikkelaars die 24/7 coderen
diff --git a/README.no.md b/README.no.md index b51efe7100..0b4200e65e 100644 --- a/README.no.md +++ b/README.no.md @@ -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
@@ -799,74 +797,6 @@ Settings → API Configuration: --- -## 📊 Tilgjengelige modeller - -
-Se alle tilgjengelige modeller - -**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) - -
- ---- - ## 🧪 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 + +
+Klikk for å utvide feilsøkingsveiledningen + +**«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) @@ -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 - -
-Klikk for å utvide feilsøkingsveiledningen - -**«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` -
--- @@ -1176,85 +1104,6 @@ MIT-lisens - se [LICENSE](LICENSE) for detaljer. --- ---- - -## 🇧🇷 OmniRoute — Gateway de IA Gratuito - - - -### 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) - ---- -
Bygget med ❤️ for utviklere som koder 24/7
diff --git a/README.phi.md b/README.phi.md index ae5ba55046..b4067e8af7 100644 --- a/README.phi.md +++ b/README.phi.md @@ -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
@@ -799,74 +797,6 @@ Settings → API Configuration: --- -## 📊 Mga Magagamit na Modelo - -
-Tingnan ang lahat ng available na modelo - -**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) - -
- ---- - ## 🧪 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 + +
+Mag-click upang palawakin ang gabay sa pag-troubleshoot + +**"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) @@ -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 - -
-Mag-click upang palawakin ang gabay sa pag-troubleshoot - -**"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 -
--- @@ -1176,85 +1104,6 @@ Lisensya ng MIT - tingnan ang [LICENSE](LICENSE) para sa mga detalye. --- ---- - -## 🇧🇷 OmniRoute — Gateway de IA Gratuito - - - -### 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) - ---- -
Built with ❤️ para sa mga developer na nagko-code 24/7
diff --git a/README.pl.md b/README.pl.md index 6ef3e7d2db..7138dcd7f2 100644 --- a/README.pl.md +++ b/README.pl.md @@ -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
@@ -799,74 +797,6 @@ Settings → API Configuration: --- -## 📊 Dostępne modele - -
-Wyświetl wszystkie dostępne modele - -**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) - -
- ---- - ## 🧪 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 + +
+Kliknij, aby rozwinąć przewodnik rozwiązywania problemów + +**„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) > **⚠️ 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 - -
-Kliknij, aby rozwinąć przewodnik rozwiązywania problemów - -**„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` -
--- @@ -1176,85 +1104,6 @@ Licencja MIT — szczegółowe informacje można znaleźć w [LICENSE](LICENSE). --- ---- - -## 🇧🇷 OmniRoute — bezpłatna bramka IA - - - -### 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) - ---- -
Zbudowany z ❤️ dla programistów, którzy kodują 24 godziny na dobę, 7 dni w tygodniu
diff --git a/README.pt-BR.md b/README.pt-BR.md index 856a61859f..d4c7c2c8e9 100644 --- a/README.pt-BR.md +++ b/README.pt-BR.md @@ -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
@@ -806,74 +806,6 @@ Configurações → Configuração de API: --- -## 📊 Modelos Disponíveis - -
-Ver todos os modelos disponíveis - -**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) - -
- ---- - ## 🧪 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. diff --git a/README.pt.md b/README.pt.md index 914e706c75..84be7e7e0a 100644 --- a/README.pt.md +++ b/README.pt.md @@ -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
@@ -799,74 +797,6 @@ Settings → API Configuration: --- -## 📊 Modelos Disponíveis - -
-Ver todos os modelos disponíveis - -**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) - -
- ---- - ## 🧪 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 + +
+Clique para expandir o guia de solução de problemas + +**"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) > **⚠️ 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 - -
-Clique para expandir o guia de solução de problemas - -**"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` -
--- @@ -1176,85 +1104,6 @@ Licença MIT - consulte [LICENSE](LICENSE) para obter detalhes. --- ---- - -## 🇧🇷 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 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) - ---- -
Construído com ❤️ para desenvolvedores que codificam 24 horas por dia, 7 dias por semana
diff --git a/README.ro.md b/README.ro.md index 1c112cee19..2b82040f71 100644 --- a/README.ro.md +++ b/README.ro.md @@ -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
@@ -799,74 +797,6 @@ Settings → API Configuration: --- -## 📊 Modele disponibile - -
-Vedeți toate modelele disponibile - -**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) - -
- ---- - ## 🧪 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 + +
+Faceți clic pentru a extinde ghidul de depanare + +**„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ță) > **⚠️ 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 - -
-Faceți clic pentru a extinde ghidul de depanare - -**„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` -
--- @@ -1176,85 +1104,6 @@ Licență MIT - consultați [LICENSE](LICENSE) pentru detalii. --- ---- - -## 🇧🇷 OmniRoute — Gateway de IA Gratuito - - - -### 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) - ---- -
Construit cu ❤️ pentru dezvoltatorii care codifică 24/7
diff --git a/README.ru.md b/README.ru.md index f38ddc858c..de1db33760 100644 --- a/README.ru.md +++ b/README.ru.md @@ -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... +``` + +--- + ## 📖 Руководство по настройке
@@ -778,74 +778,6 @@ Dashboard → CLI Tools → OpenClaw → Выбрать модель → При --- -## 📊 Доступные модели - -
-Посмотреть все доступные модели - -**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) - -
- ---- - ## 🧪 Оценки (Evals) OmniRoute включает встроенный фреймворк оценки для тестирования качества ответов LLM по golden set. Доступ через **Analytics → Evals** в dashboard. diff --git a/README.sk.md b/README.sk.md index 5d1accf0c8..f677a0513a 100644 --- a/README.sk.md +++ b/README.sk.md @@ -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
@@ -800,74 +798,6 @@ Settings → API Configuration: --- -## 📊 Dostupné modely - -
-Zobraziť všetky dostupné modely - -**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) - -
- ---- - ## 🧪 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 + +
+Kliknutím rozbalíte sprievodcu riešením problémov + +**„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) @@ -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 - -
-Kliknutím rozbalíte sprievodcu riešením problémov - -**„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` -
--- @@ -1177,85 +1105,6 @@ Licencia MIT – podrobnosti nájdete na stránke [LICENSE](LICENSE). --- ---- - -## 🇧🇷 OmniRoute — Gateway de IA Gratuito - - - -### 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) - ---- -
Vytvorené pomocou ❤️ pre vývojárov, ktorí kódujú 24/7
diff --git a/README.sv.md b/README.sv.md index 61a2e3c921..c60d27271c 100644 --- a/README.sv.md +++ b/README.sv.md @@ -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
@@ -799,74 +797,6 @@ Settings → API Configuration: --- -## 📊 Tillgängliga modeller - -
-Visa alla tillgängliga modeller - -**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) - -
- ---- - ## 🧪 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 + +
+Klicka för att expandera felsökningsguide + +**"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) @@ -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 - -
-Klicka för att expandera felsökningsguide - -**"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` -
--- @@ -1176,85 +1104,6 @@ MIT-licens - se [LICENSE](LICENSE) för detaljer. --- ---- - -## 🇧🇷 OmniRoute — Gateway de IA Gratuito - - - -### 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) - ---- -
Byggd med ❤️ för utvecklare som kodar 24/7
diff --git a/README.th.md b/README.th.md index 929211b818..da47ad2e7e 100644 --- a/README.th.md +++ b/README.th.md @@ -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... +``` + +--- + ## 📖 คู่มือการตั้งค่า
@@ -792,74 +790,6 @@ Settings → API Configuration: --- -## 📊 รุ่นที่มีจำหน่าย - -
-ดูรุ่นที่มีทั้งหมด - -**รหัสโคลด (`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) - -
- ---- - ## 🧪 การประเมินผล (Evals) OmniRoute มีกรอบการประเมินในตัวเพื่อทดสอบคุณภาพการตอบสนองของ LLM เทียบกับชุดทอง เข้าถึงได้ผ่านทาง **Analytics → Evals** ในแดชบอร์ด @@ -883,7 +813,57 @@ OmniRoute มีกรอบการประเมินในตัวเพ --- -## 🔐 OAuth ในเซิร์ฟเวอร์ Remoto (การตั้งค่า OAuth ระยะไกล) +## 🐛 การแก้ไขปัญหา + +
+คลิกเพื่อขยายคำแนะนำการแก้ปัญหา +**"โมเดลภาษาไม่ได้ระบุข้อความ"** + +- โควต้าผู้ให้บริการหมด → ตรวจสอบตัวติดตามโควต้าแดชบอร์ด +- วิธีแก้ไข: ใช้ทางเลือกแบบคอมโบหรือเปลี่ยนไปใช้ระดับที่ถูกกว่า + +**จำกัดอัตรา** + +- โควต้าการสมัครสมาชิกหมด → สำรองไปที่ 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 ระยะไกล) @@ -974,58 +954,6 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux > วิธีแก้ปัญหาเบื้องต้นคือทำการเปลี่ยนเส้นทางโดยอัตโนมัติและทำการเปลี่ยนเส้นทางโดยอัตโนมัติ ---- - -## 🐛 การแก้ไขปัญหา - -
-คลิกเพื่อขยายคำแนะนำการแก้ปัญหา -**"โมเดลภาษาไม่ได้ระบุข้อความ"** - -- โควต้าผู้ให้บริการหมด → ตรวจสอบตัวติดตามโควต้าแดชบอร์ด -- วิธีแก้ไข: ใช้ทางเลือกแบบคอมโบหรือเปลี่ยนไปใช้ระดับที่ถูกกว่า - -**จำกัดอัตรา** - -- โควต้าการสมัครสมาชิกหมด → สำรองไปที่ 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` -
--- @@ -1167,85 +1095,6 @@ gh release create v1.0.6 --title "v1.0.6" --generate-notes --- ---- - -## 🇧🇷 OmniRoute — เกตเวย์ IA ฟรี - - - -### นันคา พาเร เด โคดาร์. อัจฉริยะสำหรับ **แบบจำลอง 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) - ---- -
สร้างด้วย ❤️ สำหรับนักพัฒนาที่เขียนโค้ด 24/7
diff --git a/README.uk-UA.md b/README.uk-UA.md index 3c6ecdf04c..3a256c78b1 100644 --- a/README.uk-UA.md +++ b/README.uk-UA.md @@ -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... +``` + +--- + ## 📖 Посібник із налаштування
@@ -799,74 +797,6 @@ Settings → API Configuration: --- -## 📊 Доступні моделі - -
-Переглянути всі доступні моделі - -**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) - -
- ---- - ## 🧪 Оцінки (Evals) OmniRoute містить вбудовану систему оцінювання для перевірки якості відповіді LLM на відповідність золотому набору. Доступ до нього через **Аналітика → Оцінки** на інформаційній панелі. @@ -890,7 +820,60 @@ OmniRoute містить вбудовану систему оцінювання --- -## 🔐 OAuth em Servidor Remoto (віддалене налаштування OAuth) +## 🐛 Усунення несправностей + +
+Натисніть, щоб розгорнути посібник з усунення несправностей + +**"Мовна модель не надавала повідомлень"** + +- Квота постачальника вичерпана → Перевірте систему відстеження квот на інформаційній панелі +- Рішення: скористайтеся комбінованим альтернативним варіантом або перейдіть на дешевший рівень + +**Обмеження швидкості** + +— Вичерпана квота на підписку → Повернення до 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) @@ -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. ---- - -## 🐛 Усунення несправностей - -
-Натисніть, щоб розгорнути посібник з усунення несправностей - -**"Мовна модель не надавала повідомлень"** - -- Квота постачальника вичерпана → Перевірте систему відстеження квот на інформаційній панелі -- Рішення: скористайтеся комбінованим альтернативним варіантом або перейдіть на дешевший рівень - -**Обмеження швидкості** - -— Вичерпана квота на підписку → Повернення до 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` -
--- @@ -1178,85 +1106,6 @@ gh release create v1.0.6 --title "v1.0.6" --generate-notes --- ---- - -## 🇧🇷 OmniRoute — Gateway de IA Gratuito - - - -### 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) - ---- -
Створено з ❤️ для розробників, які працюють у режимі 24/7
diff --git a/README.vi.md b/README.vi.md index 7b3721bafd..448d13a73f 100644 --- a/README.vi.md +++ b/README.vi.md @@ -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
@@ -799,74 +797,6 @@ Settings → API Configuration: --- -## 📊 Mẫu có sẵn - -
-Xem tất cả các mẫu có sẵn - -**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) - -
- ---- - ## 🧪 Đá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ố + +
+Nhấp để mở rộng hướng dẫn khắc phục sự cố + +**"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` và `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) @@ -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ố - -
-Nhấp để mở rộng hướng dẫn khắc phục sự cố - -**"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` và `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` -
--- @@ -1176,85 +1104,6 @@ Giấy phép MIT - xem [LICENSE](LICENSE) để biết chi tiết. --- ---- - -## 🇧🇷 OmniRoute — Gateway de IA Gratuito - - - -### 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) - ---- -
Được xây dựng với ❤️ dành cho nhà phát triển viết mã 24/7
diff --git a/README.zh-CN.md b/README.zh-CN.md index 613ea220fa..1d21aa9919 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -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... +``` + +--- + ## 📖 设置指南
@@ -778,74 +778,6 @@ codex "your prompt" --- -## 📊 可用模型 - -
-查看所有可用模型 - -**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) 上的任何模型 - -
- ---- - ## 🧪 评估 (Evals) OmniRoute 包含内置评估框架，用于针对黄金集测试 LLM 响应质量。通过仪表板中的 **Analytics → Evals** 访问。 diff --git a/package-lock.json b/package-lock.json index f3cfcd4d75..7dba953b5f 100644 --- a/package-lock.json +++ b/package-lock.json @@ -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",