omniroute 1.4.11 → 1.6.0

package/README.id.md

@@ -0,0 +1,1238 @@
+<div align="center">
+  <img src="./docs/screenshots/MainOmniRoute.png" alt="OmniRoute Dashboard" width="800"/>
+  
+  # 🚀 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._
+
+**Penyelesaian Obrolan • Penyematan • Pembuatan Gambar • Audio • Pemeringkatan Ulang • 100% TypeScript**
+
+---
+
+### 🤖 Penyedia AI gratis untuk agen coding favorit Anda
+
+_Hubungkan alat IDE atau CLI apa pun yang didukung AI melalui OmniRoute — gerbang API gratis untuk pengkodean tanpa batas._
+
+  <table>
+    <tr>
+      <td align="center" width="110">
+        <a href="https://github.com/cline/cline">
+          <img src="./public/providers/openclaw.png" alt="OpenClaw" width="48"/><br/>
+          <b>OpenClaw</b>
+        </a><br/>
+        <sub>⭐ 205K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/HKUDS/nanobot">
+          <img src="./public/providers/nanobot.png" alt="NanoBot" width="48"/><br/>
+          <b>NanoBot</b>
+        </a><br/>
+        <sub>⭐ 20.9K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/sipeed/picoclaw">
+          <img src="./public/providers/picoclaw.jpg" alt="PicoClaw" width="48"/><br/>
+          <b>PicoClaw</b>
+        </a><br/>
+        <sub>⭐ 14.6K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/zeroclaw-labs/zeroclaw">
+          <img src="./public/providers/zeroclaw.png" alt="ZeroClaw" width="48"/><br/>
+          <b>ZeroClaw</b>
+        </a><br/>
+        <sub>⭐ 9.9K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/nearai/ironclaw">
+          <img src="./public/providers/ironclaw.png" alt="IronClaw" width="48"/><br/>
+          <b>IronClaw</b>
+        </a><br/>
+        <sub>⭐ 2.1K</sub>
+      </td>
+    </tr>
+    <tr>
+      <td align="center" width="110">
+        <a href="https://github.com/anomalyco/opencode">
+          <img src="./public/providers/opencode.svg" alt="OpenCode" width="48"/><br/>
+          <b>OpenCode</b>
+        </a><br/>
+        <sub>⭐ 106K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/openai/codex">
+          <img src="./public/providers/codex.png" alt="Codex CLI" width="48"/><br/>
+          <b>Codex CLI</b>
+        </a><br/>
+        <sub>⭐ 60.8K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/anthropics/claude-code">
+          <img src="./public/providers/claude.png" alt="Claude Code" width="48"/><br/>
+          <b>Claude Code</b>
+        </a><br/>
+        <sub>⭐ 67.3K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/google-gemini/gemini-cli">
+          <img src="./public/providers/gemini-cli.png" alt="Gemini CLI" width="48"/><br/>
+          <b>Gemini CLI</b>
+        </a><br/>
+        <sub>⭐ 94.7K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/Kilo-Org/kilocode">
+          <img src="./public/providers/kilocode.png" alt="Kilo Code" width="48"/><br/>
+          <b>Kilo Code</b>
+        </a><br/>
+        <sub>⭐ 15.5K</sub>
+      </td>
+    </tr>
+  </table>
+
+<sub>📡 Semua agen terhubung melalui <code>http://localhost:20128/v1</code> atau <code>http://cloud.omniroute.online/v1</code> — satu konfigurasi, model tak terbatas, dan kuota</sub>
+
+---
+
+[![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute)
+[![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute)
+[![License](https://img.shields.io/github/license/diegosouzapw/OmniRoute)](https://github.com/diegosouzapw/OmniRoute/blob/main/LICENSE)
+[![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online)
+[![WhatsApp](https://img.shields.io/badge/WhatsApp-Community-25D366?logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
+
+[🌐 Website](https://omniroute.online) • [🚀 Quick Start](#-quick-start) • [💡 Features](#-key-features) • [📖 Docs](#-documentation) • [💰 Pricing](#-pricing-at-a-glance) • [💬 WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
+
+🌐 **Available in:** 🇺🇸 [English](README.md) | 🇧🇷 [Português (Brasil)](README.pt-BR.md) | 🇪🇸 [Español](README.es.md) | 🇫🇷 [Français](README.fr.md) | 🇮🇹 [Italiano](README.it.md) | 🇷🇺 [Русский](README.ru.md) | 🇨🇳 [中文 (简体)](README.zh-CN.md) | 🇩🇪 [Deutsch](README.de.md) | 🇮🇳 [हिन्दी](README.in.md) | 🇹🇭 [ไทย](README.th.md) | 🇺🇦 [Українська](README.uk-UA.md) | 🇸🇦 [العربية](README.ar.md) | 🇯🇵 [日本語](README.ja.md) | 🇻🇳 [Tiếng Việt](README.vi.md) | 🇧🇬 [Български](README.bg.md) | 🇩🇰 [Dansk](README.da.md) | 🇫🇮 [Suomi](README.fi.md) | 🇮🇱 [עברית](README.he.md) | 🇭🇺 [Magyar](README.hu.md) | 🇮🇩 [Bahasa Indonesia](README.id.md) | 🇰🇷 [한국어](README.ko.md) | 🇲🇾 [Bahasa Melayu](README.ms.md) | 🇳🇱 [Nederlands](README.nl.md) | 🇳🇴 [Norsk](README.no.md) | 🇵🇹 [Português (Portugal)](README.pt.md) | 🇷🇴 [Română](README.ro.md) | 🇵🇱 [Polski](README.pl.md) | 🇸🇰 [Slovenčina](README.sk.md) | 🇸🇪 [Svenska](README.sv.md) | 🇵🇭 [Filipino](README.phi.md)
+
+</div>
+
+---
+
+## 🤔 Mengapa OmniRoute?
+
+**Berhenti membuang-buang uang dan mencapai batas:**
+
+- <img src="https://img.shields.io/badge/✗-e74c3c?style=flat-square" height="16"/> Kuota berlangganan habis tanpa terpakai setiap bulannya
+- <img src="https://img.shields.io/badge/✗-e74c3c?style=flat-square" height="16"/> Batas kecepatan menghentikan Anda di tengah coding
+- <img src="https://img.shields.io/badge/✗-e74c3c?style=flat-square" height="16"/> API mahal ($20-50/bulan per penyedia)
+- <img src="https://img.shields.io/badge/✗-e74c3c?style=flat-square" height="16"/> Peralihan antar penyedia secara manual
+
+**OmniRoute memecahkan masalah ini:**
+
+- ✅ **Maksimalkan langganan** - Lacak kuota, gunakan setiap bit sebelum menyetel ulang
+- ✅ **Pengembalian otomatis** - Berlangganan → Kunci API → Murah → Gratis, tanpa downtime
+- ✅ **Multi-akun** - Round-robin antar akun per penyedia
+- ✅ **Universal** - Bekerja dengan Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, alat CLI apa pun
+
+---
+
+## 🔄 Cara Kerjanya
+
+```
+┌─────────────┐
+│  Your CLI   │  (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...)
+│   Tool      │
+└──────┬──────┘
+       │ http://localhost:20128/v1
+       ↓
+┌─────────────────────────────────────────┐
+│           OmniRoute (Smart Router)        │
+│  • Format translation (OpenAI ↔ Claude) │
+│  • Quota tracking + Embeddings + Images │
+│  • Auto token refresh                   │
+└──────┬──────────────────────────────────┘
+       │
+       ├─→ [Tier 1: SUBSCRIPTION] Claude Code, Codex, Gemini CLI
+       │   ↓ quota exhausted
+       ├─→ [Tier 2: API KEY] DeepSeek, Groq, xAI, Mistral, NVIDIA NIM, etc.
+       │   ↓ budget limit
+       ├─→ [Tier 3: CHEAP] GLM ($0.6/1M), MiniMax ($0.2/1M)
+       │   ↓ budget limit
+       └─→ [Tier 4: FREE] iFlow, Qwen, Kiro (unlimited)
+
+Result: Never stop coding, minimal cost
+```
+
+---
+
+## ⚡ Mulai Cepat
+
+**1. Instal secara global:**
+
+```bash
+npm install -g omniroute
+omniroute
+```
+
+🎉 Dasbor terbuka di `http://localhost:20128`
+
+| Perintah                | Deskripsi                         |
+| ----------------------- | --------------------------------- |
+| `omniroute`             | Mulai server (port default 20128) |
+| `omniroute --port 3000` | Gunakan port khusus               |
+| `omniroute --no-open`   | Jangan buka otomatis browser      |
+| `omniroute --help`      | Tampilkan bantuan                 |
+
+**2. Hubungkan penyedia GRATIS:**
+
+Dasbor → Penyedia → Hubungkan **Kode Claude** atau **Antigravitasi** → Login OAuth → Selesai!
+
+**3. Gunakan di alat CLI Anda:**
+
+```
+Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings:
+  Endpoint: http://localhost:20128/v1
+  API Key: [copy from dashboard]
+  Model: if/kimi-k2-thinking
+```
+
+**Selesai!** Mulai coding dengan model AI GRATIS.
+
+**Alternatif — dijalankan dari sumber:**
+
+```bash
+cp .env.example .env
+npm install
+PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
+```
+
+---
+
+## 🐳 buruh pelabuhan
+
+OmniRoute tersedia sebagai image Docker publik di [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute).
+
+**Lari cepat:**
+
+```bash
+docker run -d \
+  --name omniroute \
+  --restart unless-stopped \
+  -p 20128:20128 \
+  -v omniroute-data:/app/data \
+  diegosouzapw/omniroute:latest
+```
+
+**Dengan file lingkungan:**
+
+```bash
+# Copy and edit .env first
+cp .env.example .env
+
+docker run -d \
+  --name omniroute \
+  --restart unless-stopped \
+  --env-file .env \
+  -p 20128:20128 \
+  -v omniroute-data:/app/data \
+  diegosouzapw/omniroute:latest
+```
+
+**Menggunakan Docker Tulis:**
+
+```bash
+# Base profile (no CLI tools)
+docker compose --profile base up -d
+
+# CLI profile (Claude Code, Codex, OpenClaw built-in)
+docker compose --profile cli up -d
+```
+
+| Gambar                   | Tandai   | Ukuran  | Deskripsi            |
+| ------------------------ | -------- | ------- | -------------------- |
+| `diegosouzapw/omniroute` | `latest` | ~250 MB | Rilis stabil terbaru |
+| `diegosouzapw/omniroute` | `1.0.3`  | ~250 MB | Versi saat ini       |
+
+---
+
+## 💰 Sekilas tentang Harga
+
+| Tingkat             | Penyedia          | Biaya                     | Reset Kuota               | Terbaik Untuk               |
+| ------------------- | ----------------- | ------------------------- | ------------------------- | --------------------------- |
+| **💳 BERLANGGANAN** | Kode Claude (Pro) | $20/bln                   | 5 jam + mingguan          | Sudah berlangganan          |
+|                     | Kodeks (Plus/Pro) | $20-200/bln               | 5 jam + mingguan          | Pengguna OpenAI             |
+|                     | CLI Gemini        | **GRATIS**                | 180K/bln + 1K/hari        | Setiap orang!               |
+|                     | Kopilot GitHub    | $10-19/bln                | Bulanan                   | Pengguna GitHub             |
+| **🔑 KUNCI API**    | NVIDIA NIM        | **GRATIS** (1000 sks)     | Satu kali                 | Pengujian tingkat gratis    |
+|                     | Pencarian Dalam   | Bayar per penggunaan      | Tidak ada                 | Harga/kualitas terbaik      |
+|                     | Bagus             | Tingkat gratis + berbayar | Tarif terbatas            | Inferensi ultra-cepat       |
+|                     | xAI (Grok)        | Bayar per penggunaan      | Tidak ada                 | Model Grok                  |
+|                     | Mistral           | Tingkat gratis + berbayar | Tarif terbatas            | AI Eropa                    |
+|                     | BukaRouter        | Bayar per penggunaan      | Tidak ada                 | 100+ model                  |
+| **💰 MURAH**        | GLM-4.7           | $0,6/1 juta               | Setiap hari pukul 10 pagi | Cadangan anggaran           |
+|                     | MiniMax M2.1      | $0,2/1 juta               | 5 jam bergulir            | Pilihan termurah            |
+|                     | Kimi K2           | $9/bln tetap              | 10 juta token/bln         | Biaya yang dapat diprediksi |
+| **🆓 GRATIS**       | iFlow             | $0                        | Tidak terbatas            | 8 model gratis              |
+|                     | Qwen              | $0                        | Tidak terbatas            | 3 model gratis              |
+|                     | Kiro              | $0                        | Tidak terbatas            | Claude gratis               |
+
+**💡 Kiat Pro:** Mulai dengan Gemini CLI (gratis 180 ribu/bulan) + kombo iFlow (gratis tanpa batas) = ​​biaya $0!
+
+---
+
+## 🎯 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
+
+| Fitur                                | Apa Fungsinya                                                                      |
+| ------------------------------------ | ---------------------------------------------------------------------------------- |
+| 🎯 **Pengembalian 4 Tingkat Cerdas** | Rute otomatis: Berlangganan → Kunci API → Murah → Gratis                           |
+| 📊 **Pelacakan Kuota Waktu Nyata**   | Jumlah token langsung + setel ulang hitungan mundur per penyedia                   |
+| 🔄 **Terjemahan Format**             | OpenAI ↔ Claude ↔ Gemini ↔ Kursor ↔ Kiro mulus + sanitasi respons                  |
+| 👥 **Dukungan Multi-Akun**           | Banyak akun per penyedia dengan pilihan cerdas                                     |
+| 🔄 **Penyegaran Token Otomatis**     | Token OAuth disegarkan secara otomatis dengan coba lagi                            |
+| 🎨 **Kombo Khusus**                  | 6 strategi: isi dulu, round-robin, p2c, acak, paling jarang digunakan, hemat biaya |
+| 🧩 **Model Khusus**                  | Tambahkan ID model apa pun ke penyedia mana pun                                    |
+| 🌐 **Router Wildcard**               | Rutekan pola `provider/*` ke penyedia mana pun secara dinamis                      |
+| 🧠 **Memikirkan Anggaran**           | Mode passthrough, otomatis, kustom, dan adaptif untuk model penalaran              |
+| 💬 **Injeksi Perintah Sistem**       | Perintah sistem global diterapkan di semua permintaan                              |
+| 📄 **API Respons**                   | Dukungan penuh OpenAI Responses API (`/v1/responses`) untuk Codex                  |
+
+### 🎵 API Multi-Modal
+
+| Fitur                      | Apa Fungsinya                                          |
+| -------------------------- | ------------------------------------------------------ |
+| 🖼️ **Pembuatan Gambar**    | `/v1/images/generations` — 4 penyedia, 9+ model        |
+| 📐 **Sematan**             | `/v1/embeddings` — 6 penyedia, 9+ model                |
+| 🎤 **Transkripsi Audio**   | `/v1/audio/transcriptions` — Kompatibel dengan bisikan |
+| 🔊 **Teks-ke-Ucapan**      | `/v1/audio/speech` — Sintesis audio multi-penyedia     |
+| 🛡️ **Moderasi**            | `/v1/moderations` — Pemeriksaan keamanan konten        |
+| 🔀 **Pemeringkatan Ulang** | `/v1/rerank` — Pemeringkatan ulang relevansi dokumen   |
+
+### 🛡️ Ketahanan & Keamanan
+
+| Fitur                                | Apa Fungsinya                                                                              |
+| ------------------------------------ | ------------------------------------------------------------------------------------------ |
+| 🔌 **Pemutus Arus**                  | Buka/tutup otomatis per penyedia dengan ambang batas yang dapat dikonfigurasi              |
+| 🛡️ **Kawanan Anti Guntur**           | Batas kecepatan mutex + semaphore untuk penyedia kunci API                                 |
+| 🧠 **Cache Semantik**                | Cache dua tingkat (tanda tangan + semantik) mengurangi biaya & latensi                     |
+| ⚡ **Minta Idempotensi**             | Jendela dedup 5 detik untuk permintaan duplikat                                            |
+| 🔒 **Spoofing Sidik Jari TLS**       | Lewati deteksi bot berbasis TLS melalui wreq-js                                            |
+| 🌐 **Pemfilteran IP**                | Daftar yang diizinkan/daftar blokir untuk kontrol akses API                                |
+| 📊 **Batas Tarif yang Dapat Diedit** | RPM yang dapat dikonfigurasi, celah minimum, dan maks secara bersamaan pada tingkat sistem |
+| 🛡 **Perlindungan Titik Akhir API**  | Gerbang autentikasi + pemblokiran penyedia untuk titik akhir `/models`                     |
+| 🔒 **Visibilitas Proksi**            | Lencana berkode warna: 🟢 global, 🟡 penyedia, 🔵 per koneksi dengan tampilan IP           |
+| 🌐 **Konfigurasi Proksi 3 Tingkat**  | Konfigurasikan proxy di tingkat global, per penyedia, atau per koneksi                     |
+
+### 📊 Observabilitas & Analisis
+
+| Fitur                        | Apa Fungsinya                                                                   |
+| ---------------------------- | ------------------------------------------------------------------------------- |
+| 📝 **Permintaan Pencatatan** | Mode debug dengan log permintaan/respons lengkap                                |
+| 💾 **Log Proksi SQLite**     | Log proksi persisten bertahan saat server dimulai ulang                         |
+| 📊 **Dasbor Analitik**       | Didukung grafik ulang: kartu stat, bagan penggunaan model, tabel penyedia       |
+| 📈 **Pelacakan Kemajuan**    | Ikut serta dalam acara kemajuan SSE untuk streaming                             |
+| 🧪 **Evaluasi LLM**          | Pengujian set emas dengan 4 strategi pertandingan                               |
+| 🔍 **Permintaan Telemetri**  | agregasi latensi p50/p95/p99 + penelusuran X-Request-Id                         |
+| 📋 **Dasbor Log**            | Halaman 4 tab terpadu: Log Permintaan, Log Proksi, Log Audit, Konsol            |
+| 🖥️ **Penampil Log Konsol**   | Penampil gaya terminal real-time dengan filter level, pencarian, gulir otomatis |
+| 📑 **Logging Berbasis File** | Pencegat konsol menangkap semua output ke file log JSON dengan rotasi           |
+| 🏥 **Dasbor Kesehatan**      | Waktu aktif sistem, status pemutus sirkuit, penguncian, statistik cache         |
+| 💰 **Pelacakan Biaya**       | Manajemen anggaran + konfigurasi harga per model                                |
+
+### ☁️ Penerapan & Sinkronisasi
+
+| Fitur                        | Apa Fungsinya                                                                |
+| ---------------------------- | ---------------------------------------------------------------------------- |
+| 💾 **Sinkronisasi Cloud**    | Sinkronkan konfigurasi antar perangkat melalui Cloudflare Workers            |
+| 🌐 **Terapkan Di Mana Saja** | Localhost, VPS, Docker, Pekerja Cloudflare                                   |
+| 🔑 **Manajemen Kunci API**   | Menghasilkan, memutar, dan mencakup kunci API per penyedia                   |
+| 🧙 **Wizard Orientasi**      | Penyiapan terpandu 4 langkah untuk pengguna pertama kali                     |
+| 🔧 **Dasbor Alat CLI**       | Konfigurasikan sekali klik Claude, Codex, Cline, OpenClaw, Kilo, Antigravity |
+| 🔄 **Cadangan DB**           | Pencadangan, pemulihan, ekspor & impor otomatis untuk semua pengaturan       |
+| 🌐 **Internasionalisasi**    | I18n lengkap dengan next-intl — Dukungan Inggris + Portugis (Brasil)         |
+| 🌍 **Pemilih Bahasa**        | Ikon bola dunia di header untuk peralihan bahasa secara real-time (🇮🇩/🇧🇷)    |
+| 📂 **Direktori Data Khusus** | `DATA_DIR` env var untuk mengganti jalur penyimpanan `~/.omniroute` default  |
+
+<details>
+<summary><b>📖 Detail Fitur</b></summary>
+
+### 🎯 Penggantian 4 Tingkat yang Cerdas
+
+Buat kombo dengan fallback otomatis:
+
+```
+Combo: "my-coding-stack"
+  1. cc/claude-opus-4-6        (your subscription)
+  2. nvidia/llama-3.3-70b      (free NVIDIA API)
+  3. glm/glm-4.7               (cheap backup, $0.6/1M)
+  4. if/kimi-k2-thinking       (free fallback)
+
+→ Auto switches when quota runs out or errors occur
+```
+
+### 📊 Pelacakan Kuota Waktu Nyata
+
+- Konsumsi token per penyedia
+- Atur ulang hitungan mundur (5 jam, harian, mingguan)
+- Estimasi biaya untuk tingkatan berbayar
+- Laporan pengeluaran bulanan
+
+### 🔄 Format Terjemahan
+
+Terjemahan mulus antar format:
+
+- **OpenAI** ↔ **Claude** ↔ **Gemini** ↔ **Respon OpenAI**
+- Alat CLI Anda mengirimkan format OpenAI → OmniRoute menerjemahkan → Penyedia menerima format asli
+- Bekerja dengan alat apa pun yang mendukung titik akhir OpenAI khusus
+- **Sanitasi respons** — Menghapus kolom non-standar untuk kompatibilitas OpenAI SDK yang ketat
+- **Normalisasi peran** — `developer` → `system` untuk non-OpenAI; `system` → `user` untuk model GLM/ERNIE
+- **Think tag ekstraksi** — `<think>` blok → `reasoning_content` untuk model berpikir
+- **Keluaran terstruktur** — `json_schema` → `responseMimeType`/`responseSchema` Gemini
+
+### 👥 Dukungan Multi-Akun
+
+- Tambahkan beberapa akun per penyedia
+- Perutean otomatis round-robin atau berbasis prioritas
+- Penggantian ke akun berikutnya ketika ada yang mencapai kuota
+
+### 🔄 Penyegaran Token Otomatis
+
+- Token OAuth secara otomatis disegarkan sebelum masa berlakunya habis
+- Tidak diperlukan otentikasi ulang manual
+- Pengalaman mulus di semua penyedia
+
+### 🎨 Kombo Khusus
+
+- Buat kombinasi model tanpa batas
+- 6 strategi: isi pertama, round-robin, kekuatan dua pilihan, acak, paling jarang digunakan, hemat biaya
+- Bagikan kombo di seluruh perangkat dengan Cloud Sync
+
+### 🏥 Dasbor Kesehatan
+
+- Status sistem (waktu aktif, versi, penggunaan memori)
+- Status pemutus sirkuit per penyedia (Tertutup/Terbuka/Setengah Terbuka)
+- Status batas tarif dan penguncian aktif
+- Statistik cache tanda tangan
+- Telemetri latensi (p50/p95/p99) + cache cepat
+- Atur ulang status kesehatan dengan satu klik
+
+### 🔧 Taman Bermain Penerjemah
+
+OmniRoute menyertakan Taman Bermain Penerjemah bawaan yang canggih dengan **4 mode** untuk melakukan debug, menguji, dan memantau terjemahan API:
+
+| Modus                   | Deskripsi                                                                                                                                                                                                                                                 |
+| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **💻 Taman bermain**    | Terjemahan format langsung — tempelkan isi permintaan API apa pun dan langsung lihat bagaimana OmniRoute menerjemahkannya antar format penyedia (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). Termasuk contoh templat dan deteksi otomatis format.          |
+| **💬 Penguji Obrolan**  | Kirim permintaan obrolan nyata melalui OmniRoute dan lihat perjalanan pulang pergi selengkapnya: masukan Anda, permintaan yang diterjemahkan, respons penyedia, dan respons yang diterjemahkan kembali. Sangat berharga untuk memvalidasi perutean kombo. |
+| **🧪 Bangku Tes**       | Mode pengujian batch — tentukan beberapa kasus pengujian dengan masukan berbeda dan keluaran yang diharapkan, jalankan semuanya sekaligus, dan bandingkan hasilnya di seluruh penyedia dan model.                                                         |
+| **📱 Monitor Langsung** | Pemantauan permintaan waktu nyata — perhatikan permintaan masuk saat mengalir melalui OmniRoute, lihat terjemahan format yang terjadi secara langsung, dan identifikasi masalah secara instan.                                                            |
+
+**Akses:** Dasbor → Penerjemah (bilah samping)
+
+### 💾 Sinkronisasi Awan
+
+- Sinkronisasi penyedia, kombo, dan pengaturan di seluruh perangkat
+- Sinkronisasi latar belakang otomatis
+- Penyimpanan terenkripsi yang aman
+
+</details>
+
+---
+
+## 📖 Panduan Pengaturan
+
+<details>
+<summary><b>💳 Penyedia Langganan</b></summary>
+
+### Kode Claude (Pro/Maks)
+
+```bash
+Dashboard → Providers → Connect Claude Code
+→ OAuth login → Auto token refresh
+→ 5-hour + weekly quota tracking
+
+Models:
+  cc/claude-opus-4-6
+  cc/claude-sonnet-4-5-20250929
+  cc/claude-haiku-4-5-20251001
+```
+
+**Kiat Pro:** Gunakan Opus untuk tugas kompleks, Soneta untuk kecepatan. OmniRoute melacak kuota per model!
+
+### Kodeks OpenAI (Plus/Pro)
+
+```bash
+Dashboard → Providers → Connect Codex
+→ OAuth login (port 1455)
+→ 5-hour + weekly reset
+
+Models:
+  cx/gpt-5.2-codex
+  cx/gpt-5.1-codex-max
+```
+
+### Gemini CLI (GRATIS 180K/bulan!)
+
+```bash
+Dashboard → Providers → Connect Gemini CLI
+→ Google OAuth
+→ 180K completions/month + 1K/day
+
+Models:
+  gc/gemini-3-flash-preview
+  gc/gemini-2.5-pro
+```
+
+**Nilai Terbaik:** Tingkat gratis yang sangat besar! Gunakan ini sebelum tingkatan berbayar.
+
+### Kopilot GitHub
+
+```bash
+Dashboard → Providers → Connect GitHub
+→ OAuth via GitHub
+→ Monthly reset (1st of month)
+
+Models:
+  gh/gpt-5
+  gh/claude-4.5-sonnet
+  gh/gemini-3-pro
+```
+
+</details>
+
+<details>
+<summary><b>🔑 Penyedia Kunci API</b></summary>
+
+### NVIDIA NIM (GRATIS 1000 kredit!)
+
+1. Daftar: [build.nvidia.com](https://build.nvidia.com)
+2. Dapatkan kunci API gratis (termasuk 1000 kredit inferensi)
+3. Dasbor → Tambah Penyedia → NVIDIA NIM:
+   - Kunci API: `nvapi-your-key`
+
+**Model:** `nvidia/llama-3.3-70b-instruct`, `nvidia/mistral-7b-instruct`, dan 50+ lainnya
+
+**Kiat Pro:** API yang kompatibel dengan OpenAI — bekerja secara lancar dengan terjemahan format OmniRoute!
+
+### Pencarian Dalam
+
+1. Daftar: [platform.deepseek.com](https://platform.deepseek.com)
+2. Dapatkan kunci API
+3. Dasbor → Tambah Penyedia → DeepSeek
+
+**Model:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder`
+
+### Groq (Tersedia Tingkat Gratis!)
+
+1. Daftar: [console.groq.com](https://console.groq.com)
+2. Dapatkan kunci API (termasuk tingkat gratis)
+3. Dasbor → Tambah Penyedia → Groq
+
+**Model:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b`
+
+**Kiat Pro:** Inferensi ultra-cepat — terbaik untuk pengkodean waktu nyata!
+
+### OpenRouter (100+ Model)
+
+1. Daftar: [openrouter.ai](https://openrouter.ai)
+2. Dapatkan kunci API
+3. Dasbor → Tambah Penyedia → OpenRouter
+
+**Model:** Akses 100+ model dari semua penyedia utama melalui satu kunci API.
+
+</details>
+
+<details>
+<summary><b>💰 Penyedia Murah (Cadangan)</b></summary>
+
+### GLM-4.7 (Reset harian, $0,6/1 juta)
+
+1. Daftar: [Zhipu AI](https://open.bigmodel.cn/)
+2. Dapatkan kunci API dari Coding Plan
+3. Dasbor → Tambahkan Kunci API:
+   - Penyedia: `glm`
+   - Kunci API: `your-key`
+
+**Gunakan:** `glm/glm-4.7`
+
+**Tips Pro:** Paket Coding menawarkan 3× kuota dengan biaya 1/7! Reset setiap hari pukul 10.00.
+
+### MiniMax M2.1 (reset 5 jam, $0,20/1 juta)
+
+1. Daftar: [MiniMax](https://www.minimax.io/)
+2. Dapatkan kunci API
+3. Dasbor → Tambahkan Kunci API
+
+**Gunakan:** `minimax/MiniMax-M2.1`
+
+**Kiat Pro:** Opsi termurah untuk konteks panjang (1 juta token)!
+
+### Kimi K2 ($9/bulan tetap)
+
+1. Berlangganan: [Moonshot AI](https://platform.moonshot.ai/)
+2. Dapatkan kunci API
+3. Dasbor → Tambahkan Kunci API
+
+**Gunakan:** `kimi/kimi-latest`
+
+**Kiat Pro:** Memperbaiki $9/bulan untuk 10 juta token = biaya efektif $0,90/1 juta!
+
+</details>
+
+<details>
+<summary><b>🆓 Penyedia GRATIS (Cadangan Darurat)</b></summary>
+
+### iFlow (8 model GRATIS)
+
+```bash
+Dashboard → Connect iFlow
+→ iFlow OAuth login
+→ Unlimited usage
+
+Models:
+  if/kimi-k2-thinking
+  if/qwen3-coder-plus
+  if/glm-4.7
+  if/minimax-m2
+  if/deepseek-r1
+```
+
+### Qwen (3 model GRATIS)
+
+```bash
+Dashboard → Connect Qwen
+→ Device code authorization
+→ Unlimited usage
+
+Models:
+  qw/qwen3-coder-plus
+  qw/qwen3-coder-flash
+```
+
+### Kiro (Claude GRATIS)
+
+```bash
+Dashboard → Connect Kiro
+→ AWS Builder ID or Google/GitHub
+→ Unlimited usage
+
+Models:
+  kr/claude-sonnet-4.5
+  kr/claude-haiku-4.5
+```
+
+</details>
+
+<details>
+<summary><b>🎨 Buat Kombo</b></summary>
+
+### Contoh 1: Maksimalkan Langganan → Cadangan Murah
+
+```
+Dashboard → Combos → Create New
+
+Name: premium-coding
+Models:
+  1. cc/claude-opus-4-6 (Subscription primary)
+  2. glm/glm-4.7 (Cheap backup, $0.6/1M)
+  3. minimax/MiniMax-M2.1 (Cheapest fallback, $0.20/1M)
+
+Use in CLI: premium-coding
+```
+
+### Contoh 2: Gratis Saja (Tanpa Biaya)
+
+```
+Name: free-combo
+Models:
+  1. gc/gemini-3-flash-preview (180K free/month)
+  2. if/kimi-k2-thinking (unlimited)
+  3. qw/qwen3-coder-plus (unlimited)
+
+Cost: $0 forever!
+```
+
+</details>
+
+<details>
+<summary><b>🔧 Integrasi CLI</b></summary>
+
+### IDE Kursor
+
+```
+Settings → Models → Advanced:
+  OpenAI API Base URL: http://localhost:20128/v1
+  OpenAI API Key: [from OmniRoute dashboard]
+  Model: cc/claude-opus-4-6
+```
+
+### Kode Claude
+
+Gunakan halaman **Alat CLI** di dasbor untuk konfigurasi sekali klik, atau edit `~/.claude/settings.json` secara manual.
+
+### Kodeks CLI
+
+```bash
+export OPENAI_BASE_URL="http://localhost:20128"
+export OPENAI_API_KEY="your-omniroute-api-key"
+
+codex "your prompt"
+```
+
+### Buka Cakar
+
+**Opsi 1 — Dasbor (disarankan):**
+
+```
+Dashboard → CLI Tools → OpenClaw → Select Model → Apply
+```
+
+**Opsi 2 — Panduan:** Sunting `~/.openclaw/openclaw.json`:
+
+```json
+{
+  "models": {
+    "providers": {
+      "omniroute": {
+        "baseUrl": "http://127.0.0.1:20128/v1",
+        "apiKey": "sk_omniroute",
+        "api": "openai-completions"
+      }
+    }
+  }
+}
+```
+
+> **Catatan:** OpenClaw hanya berfungsi dengan OmniRoute lokal. Gunakan `127.0.0.1` alih-alih `localhost` untuk menghindari masalah resolusi IPv6.
+
+### Cline / Lanjutkan / RooCode
+
+```
+Settings → API Configuration:
+  Provider: OpenAI Compatible
+  Base URL: http://localhost:20128/v1
+  API Key: [from OmniRoute dashboard]
+  Model: if/kimi-k2-thinking
+```
+
+</details>
+
+---
+
+## 📊 Model yang Tersedia
+
+<details>
+<summary><b>Lihat semua model yang tersedia</b></summary>
+
+**Kode Claude (`cc/`)** - Pro/Maks:
+
+- `cc/claude-opus-4-6`
+- `cc/claude-sonnet-4-5-20250929`
+- `cc/claude-haiku-4-5-20251001`
+
+**Kodeks (`cx/`)** - Plus/Pro:
+
+- `cx/gpt-5.2-codex`
+- `cx/gpt-5.1-codex-max`
+
+**Gemini CLI (`gc/`)** - GRATIS:
+
+- `gc/gemini-3-flash-preview`
+- `gc/gemini-2.5-pro`
+
+**Copilot GitHub (`gh/`)**:
+
+- `gh/gpt-5`
+- `gh/claude-4.5-sonnet`
+
+**NVIDIA NIM (`nvidia/`)** - Kredit GRATIS:
+
+- `nvidia/llama-3.3-70b-instruct`
+- `nvidia/mistral-7b-instruct`
+- 50+ model lainnya di [build.nvidia.com](https://build.nvidia.com)
+
+**GLM (`glm/`)** - $0,6/1 juta:
+
+- `glm/glm-4.7`
+
+**MiniMax (`minimax/`)** - $0,2/1 juta:
+
+- `minimax/MiniMax-M2.1`
+
+**iFlow (`if/`)** - GRATIS:
+
+- `if/kimi-k2-thinking`
+- `if/qwen3-coder-plus`
+- `if/deepseek-r1`
+- `if/glm-4.7`
+- `if/minimax-m2`
+
+**Qwen (`qw/`)** - GRATIS:
+
+- `qw/qwen3-coder-plus`
+- `qw/qwen3-coder-flash`
+
+**Kiro (`kr/`)** - GRATIS:
+
+- `kr/claude-sonnet-4.5`
+- `kr/claude-haiku-4.5`
+
+**OpenRouter (`or/`)** - 100+ model:
+
+- `or/anthropic/claude-4-sonnet`
+- `or/google/gemini-2.5-pro`
+- Model apa pun dari [openrouter.ai/models](https://openrouter.ai/models)
+
+</details>
+
+---
+
+## 🧪 Evaluasi (Eval)
+
+OmniRoute menyertakan kerangka evaluasi bawaan untuk menguji kualitas respons LLM terhadap rangkaian emas. Akses melalui **Analytics → Evals** di dasbor.
+
+### Set Emas Bawaan
+
+"OmniRoute Golden Set" yang dimuat sebelumnya berisi 10 kasus uji yang meliputi:
+
+- Salam, matematika, geografi, pembuatan kode
+- Kepatuhan format JSON, terjemahan, penurunan harga
+- Penolakan keamanan (konten berbahaya), penghitungan, logika boolean
+
+### Strategi Evaluasi
+
+| Strategi   | Deskripsi                                                    | Contoh                           |
+| ---------- | ------------------------------------------------------------ | -------------------------------- |
+| `exact`    | Output harus sama persis                                     | `"4"`                            |
+| `contains` | Output harus berisi substring (tidak peka huruf besar-kecil) | `"Paris"`                        |
+| `regex`    | Output harus sesuai dengan pola regex                        | `"1.*2.*3"`                      |
+| `custom`   | Fungsi JS khusus mengembalikan benar/salah                   | `(output) => output.length > 10` |
+
+---
+
+## 🔐 OAuth em Servidor Remoto (Pengaturan OAuth Jarak Jauh)
+
+<a name="oauth-em-servidor-remoto"></a>
+
+> **⚠️ PENTING bagi pengguna dengan OmniRoute pada VPS/Docker/server jarak jauh**
+
+### Mengapa OAuth melakukan Antigravity / Gemini CLI gagal dalam layanan jarak jauh?
+
+Pembuktiannya **Antigravitasi** dan **Gemini CLI** digunakan **Google OAuth 2.0** untuk autentikasi. Google meminta agar `redirect_uri` menggunakan OAuth yang terus berubah, jadi **exatamente** adalah URI yang sudah ada sebelumnya di Google Cloud Console yang dapat diterapkan.
+
+Karena kredensial OAuth yang diberikan pada OmniRoute adalah kadastrada **apenas untuk `localhost`**. Ketika Anda mengakses OmniRoute dari server jarak jauh (misal: `https://omniroute.meuservidor.com`), atau Google meminta autenticação com:
+
+```
+Error 400: redirect_uri_mismatch
+```
+
+### Solusi: Konfigurasikan akun OAuth Anda
+
+Anda perlu membuat **ID Klien OAuth 2.0** di Google Cloud Console dengan URI di server Anda.
+
+#### Lewati dulu
+
+**1. Mengakses Google Cloud Console**
+
+Abra: [https://console.cloud.google.com/apis/credentials](https://console.cloud.google.com/apis/credentials)
+
+**2. Inilah ID Klien OAuth 2.0 yang baru**
+
+- Klik pada **"+ Buat Kredensial"** → **"ID klien OAuth"**
+- Tip aplikasi: **"Aplikasi web"**
+- Nama: nama escolha qualquer (misal: `OmniRoute Remote`)
+
+**3. Tambahan sebagai URI Pengalihan Resmi**
+
+Selain itu **"URI pengalihan resmi"**, tambahan:
+
+```
+https://seu-servidor.com/callback
+```
+
+> Pengganti `seu-servidor.com` pelo domínio atau IP ke server Anda (termasuk port yang diperlukan, misal: `http://45.33.32.156:20128/callback`).
+
+**4. Salep dan salin sebagai kredensial**
+
+Kemudian, Google menampilkan **ID Klien** dan **Rahasia Klien**.
+
+**5. Konfigurasikan sebagai variáveis de ambiente**
+
+Di `.env` (atau berbagai lingkungan di Docker):
+
+```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. Memulai kembali OmniRoute**
+
+```bash
+# Se usando npm:
+npm run dev
+
+# Se usando Docker:
+docker restart omniroute
+```
+
+**7. Mari kita sambungkan lagi**
+
+Dasbor → Penyedia → Antigravitasi (atau Gemini CLI) → OAuth
+
+Sekarang o Google dialihkan langsung ke `https://seu-servidor.com/callback` dan autentikasi berfungsi.
+
+---
+
+### Solusi sementara (sem configurar credenciais próprias)
+
+Jika Anda tidak ingin membuat kredensial pribadi sekarang, Anda mungkin dapat menggunakan fluks **panduan URL**:
+
+1. O OmniRoute membuka URL autoriza dari Google
+2. Setelah Anda autorizar, Google mengarahkan pengalihan ke `localhost` (yang gagal pada server jarak jauh)
+3. **Salin URL lengkap** dari bilah akhir browser Anda (meskipun halaman tidak dimuat)
+4. Gunakan URL ini karena tidak ada modal koneksi ke OmniRoute
+5. Klik pada **"Hubungkan"**
+
+> Solusi ini berfungsi karena kode otorisasi pada URL valid secara independen untuk mengarahkan ulang ke akun atau tidak.
+
+---
+
+## 🐛 Pemecahan masalah
+
+<details>
+<summary><b>Klik untuk memperluas panduan pemecahan masalah</b></summary>
+
+**"Model bahasa tidak memberikan pesan"**
+
+- Kuota penyedia habis → Periksa dashboard pelacak kuota
+- Solusi: Gunakan combo fallback atau beralih ke tier yang lebih murah
+
+**Pembatasan tarif**
+
+- Kuota berlangganan habis → Penggantian ke GLM/MiniMax
+- Tambahkan kombo: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
+
+**Token OAuth kedaluwarsa**
+
+- Disegarkan secara otomatis oleh OmniRoute
+- Jika masalah terus berlanjut: Dasbor → Penyedia → Sambungkan kembali
+
+**Biaya tinggi**
+
+- Periksa statistik penggunaan di Dashboard → Biaya
+- Ganti model utama ke GLM/MiniMax
+- Gunakan tingkat gratis (Gemini CLI, iFlow) untuk tugas-tugas yang tidak penting
+
+**Dasbor terbuka pada port yang salah**
+
+- Tetapkan `PORT=20128` dan `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
+
+**Kesalahan sinkronisasi cloud**
+
+- Verifikasi `BASE_URL` poin ke instance Anda yang sedang berjalan
+- Verifikasi `CLOUD_URL` poin ke titik akhir cloud yang Anda harapkan
+- Jaga agar nilai `NEXT_PUBLIC_*` selaras dengan nilai sisi server
+
+**Login pertama tidak berfungsi**
+
+- Periksa `INITIAL_PASSWORD` di `.env`
+- Jika tidak disetel, kata sandi cadangan adalah `123456`
+
+**Tidak ada log permintaan**
+
+- Tetapkan `ENABLE_REQUEST_LOGS=true` di `.env`
+
+**Tes koneksi menunjukkan "Tidak Valid" untuk penyedia yang kompatibel dengan OpenAI**
+
+- Banyak penyedia tidak mengekspos titik akhir `/models`
+- OmniRoute v1.0.6+ menyertakan validasi fallback melalui penyelesaian obrolan
+- Pastikan URL dasar menyertakan akhiran `/v1`
+
+</details>
+
+---
+
+## 🛠️ Tumpukan Teknologi
+
+- **Runtime**: Node.js 18–22 LTS (⚠️ Node.js 24+ **tidak didukung** — `better-sqlite3` biner asli tidak kompatibel)
+- **Bahasa**: TypeScript 5.9 — **100% TypeScript** di `src/` dan `open-sse/` (v1.0.6)
+- **Kerangka Kerja**: Next.js 16 + React 19 + Tailwind CSS 4
+- **Database**: LowDB (JSON) + SQLite (status domain + log proksi)
+- **Streaming**: Peristiwa Terkirim Server (SSE)
+- **Auth**: OAuth 2.0 (PKCE) + JWT + Kunci API
+- **Pengujian**: pelari pengujian Node.js (368+ pengujian unit)
+- **CI/CD**: Tindakan GitHub (publikasi npm otomatis + Docker Hub saat dirilis)
+- **Situs Web**: [omniroute.online](https://omniroute.online)
+- **Paket**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
+- **Pekerja Pelabuhan**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
+- **Ketahanan**: Pemutus sirkuit, kemunduran eksponensial, kawanan anti-guntur, spoofing TLS
+
+---
+
+## 📖 Dokumentasi
+
+| Dokumen                                      | Deskripsi                                           |
+| -------------------------------------------- | --------------------------------------------------- |
+| [User Guide](docs/USER_GUIDE.md)             | Penyedia, kombo, integrasi CLI, penerapan           |
+| [API Reference](docs/API_REFERENCE.md)       | Semua titik akhir dengan contoh                     |
+| [Troubleshooting](docs/TROUBLESHOOTING.md)   | Masalah umum dan solusinya                          |
+| [Architecture](docs/ARCHITECTURE.md)         | Arsitektur sistem dan internal                      |
+| [Contributing](CONTRIBUTING.md)              | Pengaturan dan pedoman pengembangan                 |
+| [OpenAPI Spec](docs/openapi.yaml)            | Spesifikasi OpenAPI 3.0                             |
+| [Security Policy](SECURITY.md)               | Pelaporan kerentanan dan praktik keamanan           |
+| [VM Deployment](docs/VM_DEPLOYMENT_GUIDE.md) | Panduan lengkap: VM + nginx + Pengaturan Cloudflare |
+| [Features Gallery](docs/FEATURES.md)         | Tur dasbor visual dengan tangkapan layar            |
+
+### 📸 Pratinjau Dasbor
+
+<details>
+<summary><b>Klik untuk melihat tangkapan layar dasbor</b></summary>
+
+| Halaman            | Tangkapan layar                                   |
+| ------------------ | ------------------------------------------------- |
+| **Penyedia**       | ![Providers](docs/screenshots/01-providers.png)   |
+| **Kombo**          | ![Combos](docs/screenshots/02-combos.png)         |
+| **Analitik**       | ![Analytics](docs/screenshots/03-analytics.png)   |
+| **Kesehatan**      | ![Health](docs/screenshots/04-health.png)         |
+| **Penerjemah**     | ![Translator](docs/screenshots/05-translator.png) |
+| **Pengaturan**     | ![Settings](docs/screenshots/06-settings.png)     |
+| **Alat CLI**       | ![CLI Tools](docs/screenshots/07-cli-tools.png)   |
+| **Log Penggunaan** | ![Usage](docs/screenshots/08-usage.png)           |
+| **Titik Akhir**    | ![Endpoint](docs/screenshots/09-endpoint.png)     |
+
+</details>
+
+---
+
+## 🗺️ Peta Jalan
+
+OmniRoute memiliki **210+ fitur yang direncanakan** di berbagai fase pengembangan. Berikut adalah bidang-bidang utamanya:
+
+| Kategori                     | Fitur yang Direncanakan | Sorotan                                                                                             |
+| ---------------------------- | ----------------------- | --------------------------------------------------------------------------------------------------- |
+| 🧠 **Perutean & Kecerdasan** | 25+                     | Perutean latensi terendah, perutean berbasis tag, preflight kuota, pemilihan akun P2C               |
+| 🔒 **Keamanan & Kepatuhan**  | 20+                     | Pengerasan SSRF, penyelubungan kredensial, batas tarif per titik akhir, pelingkupan kunci manajemen |
+| 📊 **Kemampuan Observasi**   | 15+                     | Integrasi OpenTelemetry, pemantauan kuota waktu nyata, pelacakan biaya per model                    |
+| 🔄 **Integrasi Penyedia**    | 20+                     | Registri model dinamis, cooldown penyedia, Codex multi-akun, penguraian kuota Salinan               |
+| ⚡ **Kinerja**               | 15+                     | Lapisan cache ganda, cache cepat, cache respons, streaming keepalive, API batch                     |
+| 🌐 **Ekosistem**             | 10+                     | WebSocket API, konfigurasi hot-reload, penyimpanan konfigurasi terdistribusi, mode komersial        |
+
+### 🔜 Segera Hadir
+
+- 🔗 **Integrasi OpenCode** — Dukungan penyedia asli untuk IDE pengkodean AI OpenCode
+- 🔗 **Integrasi TRAE** — Dukungan penuh untuk kerangka pengembangan AI TRAE
+- 📦 **Batch API** — Pemrosesan batch asinkron untuk permintaan massal
+- 🎯 **Perutean Berbasis Tag** — Merutekan permintaan berdasarkan tag dan metadata khusus
+- 💰 **Strategi Biaya Terendah** — Secara otomatis memilih penyedia termurah yang tersedia
+
+> 📝 Spesifikasi fitur lengkap tersedia di [link](docs/new-features/) (217 spesifikasi detail)
+
+---
+
+## 📧 Dukungan
+
+> 💬 **Bergabunglah dengan komunitas kami!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Dapatkan bantuan, berbagi kiat, dan dapatkan informasi terbaru.
+
+- **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)
+- **WhatsApp**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
+- **Proyek Asli**: [9router by decolua](https://github.com/decolua/9router)
+
+---
+
+## 👥 Kontributor
+
+[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=100&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
+
+### Cara Berkontribusi
+
+1. Cabangkan repositori
+2. Buat cabang fitur Anda (`git checkout -b feature/amazing-feature`)
+3. Komit perubahan Anda (`git commit -m 'Add amazing feature'`)
+4. Dorong ke cabang (`git push origin feature/amazing-feature`)
+5. Buka Permintaan Tarik
+
+Lihat [CONTRIBUTING.md](CONTRIBUTING.md) untuk panduan detailnya.
+
+### Merilis Versi Baru
+
+```bash
+# Create a release — npm publish happens automatically
+gh release create v1.0.6 --title "v1.0.6" --generate-notes
+```
+
+---
+
+## 📊 Sejarah Bintang
+
+<a href="https://star-history.com/#diegosouzapw/OmniRoute&Date">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=diegosouzapw/OmniRoute&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=diegosouzapw/OmniRoute&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=diegosouzapw/OmniRoute&type=Date" />
+ </picture>
+</a>
+
+---
+
+## 🙏 Ucapan Terima Kasih
+
+Terima kasih khusus kepada **[9router](https://github.com/decolua/9router)** oleh **[decolua](https://github.com/decolua)** — proyek asli yang menginspirasi fork ini. OmniRoute dibangun di atas fondasi luar biasa tersebut dengan fitur tambahan, API multi-modal, dan penulisan ulang TypeScript lengkap.
+
+Terima kasih khusus kepada **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — implementasi Go asli yang menginspirasi port JavaScript ini.
+
+---
+
+## 📄 Lisensi
+
+Lisensi MIT - lihat [LICENSE](LICENSE) untuk detailnya.
+
+---
+
+---
+
+## 🇧🇷 OmniRoute — Gerbang IA Gratis
+
+<a name="-omniroute--gateway-de-ia-gratuito"></a>
+
+### Tidak ada kode apa pun. Roteamento cerdas untuk **model IA GRATIS dan hak istimewa** dengan fallback otomatis.
+
+_Proksi universal API — um titik akhir, 36+ bukti, tanpa waktu henti._
+
+### 🌐 Internasionalisasi (i18n)
+
+Pada dasbor, lakukan OmniRoute mendukung **beberapa idiom**. Saat ini kami telah membagikannya:
+
+| Idiom                 | Kode    | Status     |
+| --------------------- | ------- | ---------- |
+| 🇮🇩 Bahasa Inggris     | `en`    | ✅ Lengkap |
+| 🇧🇷 Português (Brasil) | `pt-BR` | ✅ Lengkap |
+
+**Untuk trocar o idioma:** Klik no selector de idioma (🇮🇩 EN) no header do dashboard → pilih idioma yang diinginkan.
+
+**Untuk menambahkan idiom baru:**
+
+1. Teriak `src/i18n/messages/{codigo}.json` berdasarkan `en.json`
+2. Tambahan kode pada `src/i18n/config.ts` → `LOCALES` dan `LANGUAGES`
+3. Memulai kembali server
+
+### ⚡ Mulai Cepat
+
+```bash
+# Instalar via npm
+npx omniroute@latest
+
+# Ou rodar do código-fonte
+cp .env.example .env
+npm install
+PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
+```
+
+### 🐳 buruh pelabuhan
+
+```bash
+docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
+```
+
+### 🔑 Prinsip Fungsionalidades
+
+- **36+ bukti IA** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek, dan lainnya
+- **Roteamento inteligente** — Penggantian otomatis ke seluruh bukti
+- **Penulisan format** — OpenAI ↔ Claude ↔ Gemini secara otomatis
+- **Multi-konta** — Multi-konta berdasarkan pilihan yang cerdas
+- **Cache semântico** — Memulihkan biaya dan latensi
+- **OAuth otomatis** — Token diperbarui secara otomatis
+- **Kombo yang dipersonalisasi** — 6 strategi roteamento
+- **Dasbor lengkap** — Monitor, log, analisis, konfigurasi
+- **Alat CLI** — Konfigurasikan Kode Claude, Codex, Kursor, Cline com um klik
+- **100% TypeScript** — Kode limpo dan tipado
+
+### 📖 Dokumentasi
+
+| Dokumen                                         | Deskripsi                                |
+| ----------------------------------------------- | ---------------------------------------- |
+| [Guia do Usuário](docs/USER_GUIDE.md)           | Provedores, kombo, CLI, terapkan         |
+| [Referência da API](docs/API_REFERENCE.md)      | Semua titik akhir dengan contoh          |
+| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Masalah Umum dan Solusi                  |
+| [Arquitetura](docs/ARCHITECTURE.md)             | Arquitetura dan internal dalam sistem    |
+| [Contribuição](CONTRIBUTING.md)                 | Menyiapkan pedoman desenvolvimento       |
+| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md)     | Panduan lengkap: VM + nginx + Cloudflare |
+
+### 📧 Dukungan
+
+> 💬 **Entre to a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Ban dúvidas, compartilhe dicas dan fique aktualizado.
+
+- **Situs Web**: [omniroute.online](https://omniroute.online)
+- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
+- **Masalah**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
+
+---
+
+<div align="center">
+  <sub>Dibangun dengan ❤️ untuk pengembang yang membuat kode 24/7</sub>
+  <br/>
+  <sub><a href="https://omniroute.online">omniroute.online</a></sub>
+</div>