omniroute 1.4.11 → 1.6.0

package/README.md

@@ -106,7 +106,7 @@ _Connect any AI-powered IDE or CLI tool through OmniRoute — free API gateway f
 
 [🌐 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](README.pt-BR.md) | [Español](README.es.md) | [Русский](README.ru.md) | [中文](README.zh-CN.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Italiano](README.it.md)
+🌐 **Available in:** 🇺🇸 [English](README.md) | 🇧🇷 [Português (Brasil)](README.pt-BR.md) | 🇪🇸 [Español](README.es.md) | 🇫🇷 [Français](README.fr.md) | 🇮🇹 [Italiano](README.it.md) | 🇷🇺 [Русский](README.ru.md) | 🇨🇳 [中文 (简体)](README.zh-CN.md) | 🇩🇪 [Deutsch](README.de.md) | 🇮🇳 [हिन्दी](README.in.md) | 🇹🇭 [ไทย](README.th.md) | 🇺🇦 [Українська](README.uk-UA.md) | 🇸🇦 [العربية](README.ar.md) | 🇯🇵 [日本語](README.ja.md) | 🇻🇳 [Tiếng Việt](README.vi.md) | 🇧🇬 [Български](README.bg.md) | 🇩🇰 [Dansk](README.da.md) | 🇫🇮 [Suomi](README.fi.md) | 🇮🇱 [עברית](README.he.md) | 🇭🇺 [Magyar](README.hu.md) | 🇮🇩 [Bahasa Indonesia](README.id.md) | 🇰🇷 [한국어](README.ko.md) | 🇲🇾 [Bahasa Melayu](README.ms.md) | 🇳🇱 [Nederlands](README.nl.md) | 🇳🇴 [Norsk](README.no.md) | 🇵🇹 [Português (Portugal)](README.pt.md) | 🇷🇴 [Română](README.ro.md) | 🇵🇱 [Polski](README.pl.md) | 🇸🇰 [Slovenčina](README.sk.md) | 🇸🇪 [Svenska](README.sv.md) | 🇵🇭 [Filipino](README.phi.md)
 
 </div>
 
@@ -170,12 +170,22 @@ omniroute
 
 🎉 Dashboard opens at `http://localhost:20128`
 
-| Command                 | Description                       |
-| ----------------------- | --------------------------------- |
-| `omniroute`             | Start server (default port 20128) |
-| `omniroute --port 3000` | Use custom port                   |
-| `omniroute --no-open`   | Don't auto-open browser           |
-| `omniroute --help`      | Show help                         |
+| Command                 | Description                                                 |
+| ----------------------- | ----------------------------------------------------------- |
+| `omniroute`             | Start server (`PORT=20128`, API and dashboard on same port) |
+| `omniroute --port 3000` | Set canonical/API port to 3000                              |
+| `omniroute --no-open`   | Don't auto-open browser                                     |
+| `omniroute --help`      | Show help                                                   |
+
+Optional split-port mode:
+
+```bash
+PORT=20128 DASHBOARD_PORT=20129 omniroute
+# API:       http://localhost:20128/v1
+# Dashboard: http://localhost:20129
+```
+
+When ports are split, the API port serves only OpenAI-compatible routes (`/v1`, `/chat/completions`, `/responses`, `/models`, `/codex/*`).
 
 **2. Connect a FREE provider:**
 
@@ -197,7 +207,7 @@ Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings:
 ```bash
 cp .env.example .env
 npm install
-PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
+PORT=20128 DASHBOARD_PORT=20129 NEXT_PUBLIC_BASE_URL=http://localhost:20129 npm run dev
 ```
 
 ---
@@ -366,16 +376,18 @@ Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
 
 ### 🛡️ Resilience & Security
 
-| Feature                         | What It Does                                                  |
-| ------------------------------- | ------------------------------------------------------------- |
-| 🔌 **Circuit Breaker**          | Auto-open/close per-provider with configurable thresholds     |
-| 🛡️ **Anti-Thundering Herd**     | Mutex + semaphore rate-limit for API key providers            |
-| 🧠 **Semantic Cache**           | Two-tier cache (signature + semantic) reduces cost & latency  |
-| ⚡ **Request Idempotency**      | 5s dedup window for duplicate requests                        |
-| 🔒 **TLS Fingerprint Spoofing** | Bypass TLS-based bot detection via wreq-js                    |
-| 🌐 **IP Filtering**             | Allowlist/blocklist for API access control                    |
-| 📊 **Editable Rate Limits**     | Configurable RPM, min gap, and max concurrent at system level |
-| 🛡 **API Endpoint Protection**  | Auth gating + provider blocking for the `/models` endpoint    |
+| Feature                         | What It Does                                                                  |
+| ------------------------------- | ----------------------------------------------------------------------------- |
+| 🔌 **Circuit Breaker**          | Auto-open/close per-provider with configurable thresholds                     |
+| 🛡️ **Anti-Thundering Herd**     | Mutex + semaphore rate-limit for API key providers                            |
+| 🧠 **Semantic Cache**           | Two-tier cache (signature + semantic) reduces cost & latency                  |
+| ⚡ **Request Idempotency**      | 5s dedup window for duplicate requests                                        |
+| 🔒 **TLS Fingerprint Spoofing** | Bypass TLS-based bot detection via wreq-js                                    |
+| 🌐 **IP Filtering**             | Allowlist/blocklist for API access control                                    |
+| 📊 **Editable Rate Limits**     | Configurable RPM, min gap, and max concurrent at system level                 |
+| 🛡 **API Endpoint Protection**  | Auth gating + provider blocking for the `/models` endpoint                    |
+| 🔒 **Proxy Visibility**         | Color-coded badges: 🟢 global, 🟡 provider, 🔵 per-connection with IP display |
+| 🌐 **3-Level Proxy Config**     | Configure proxies at global, per-provider, or per-connection level            |
 
 ### 📊 Observability & Analytics
 
@@ -395,15 +407,17 @@ Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
 
 ### ☁️ Deployment & Sync
 
-| Feature                     | What It Does                                                          |
-| --------------------------- | --------------------------------------------------------------------- |
-| 💾 **Cloud Sync**           | Sync config across devices via Cloudflare Workers                     |
-| 🌐 **Deploy Anywhere**      | Localhost, VPS, Docker, Cloudflare Workers                            |
-| 🔑 **API Key Management**   | Generate, rotate, and scope API keys per provider                     |
-| 🧙 **Onboarding Wizard**    | 4-step guided setup for first-time users                              |
-| 🔧 **CLI Tools Dashboard**  | One-click configure Claude, Codex, Cline, OpenClaw, Kilo, Antigravity |
-| 🔄 **DB Backups**           | Automatic backup, restore, export & import for all settings           |
-| 🌐 **Internationalization** | Full i18n with next-intl — English + Portuguese (Brazil) support      |
+| Feature                      | What It Does                                                          |
+| ---------------------------- | --------------------------------------------------------------------- |
+| 💾 **Cloud Sync**            | Sync config across devices via Cloudflare Workers                     |
+| 🌐 **Deploy Anywhere**       | Localhost, VPS, Docker, Cloudflare Workers                            |
+| 🔑 **API Key Management**    | Generate, rotate, and scope API keys per provider                     |
+| 🧙 **Onboarding Wizard**     | 4-step guided setup for first-time users                              |
+| 🔧 **CLI Tools Dashboard**   | One-click configure Claude, Codex, Cline, OpenClaw, Kilo, Antigravity |
+| 🔄 **DB Backups**            | Automatic backup, restore, export & import for all settings           |
+| 🌐 **Internationalization**  | Full i18n with next-intl — 30 languages including RTL support         |
+| 🌍 **Language Selector**     | Globe icon in header for real-time switching between 30 languages     |
+| 📂 **Custom Data Directory** | `DATA_DIR` env var to override default `~/.omniroute` storage path    |
 
 <details>
 <summary><b>📖 Feature Details</b></summary>
@@ -981,9 +995,12 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux
 - Switch primary model to GLM/MiniMax
 - Use free tier (Gemini CLI, iFlow) for non-critical tasks
 
-**Dashboard opens on wrong port**
+**Dashboard/API ports are wrong**
 
-- Set `PORT=20128` and `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
+- `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**
 
@@ -1232,3 +1249,4 @@ docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
   <br/>
   <sub><a href="https://omniroute.online">omniroute.online</a></sub>
 </div>
+<!-- GitHub Discussions enabled for community Q&A -->