5.6 KiB
Szybki start: uruchom OmniRoute w 3 minuty
TL;DR: Zainstaluj → Podłącz darmowego providera → Skieruj IDE na OmniRoute. Gotowe.
Krok 1: Zainstaluj OmniRoute
Wybierz preferowaną metodę:
Opcja A: npm (zalecane)
npm install -g omniroute
Opcja B: Docker
docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
Opcja C: Ze źródeł
git clone https://github.com/diegosouzapw/OmniRoute.git
cd OmniRoute
npm install
npm run dev
Krok 2: Uruchom OmniRoute
omniroute
OmniRoute startuje pod adresem http://localhost:20128. Dashboard otwiera się automatycznie.
Krok 3: Podłącz darmowego providera
Możesz korzystać z OmniRoute bez żadnych opłat, podłączając darmowego providera.
Opcja A: Kiro (darmowy Claude — bez karty kredytowej)
- Otwórz dashboard pod adresem
http://localhost:20128 - Przejdź do Providers → Add Provider
- Wybierz Kiro AI
- Kliknij Connect (klucz API nie jest potrzebny!)
- Gotowe! Masz darmowy dostęp do modeli Claude.
Opcja B: OpenCode Free (bez autoryzacji)
- Otwórz dashboard pod adresem
http://localhost:20128 - Przejdź do Providers → Add Provider
- Wybierz OpenCode Free
- Kliknij Connect (klucz API nie jest potrzebny!)
- Gotowe! Masz darmowy dostęp do wielu modeli.
Opcja C: Pollinations (bez klucza)
- Otwórz dashboard pod adresem
http://localhost:20128 - Przejdź do Providers → Add Provider
- Wybierz Pollinations
- Kliknij Connect (klucz API nie jest potrzebny!)
- Gotowe! Masz darmowy dostęp do GPT-5, Claude, Gemini i innych.
Krok 4: Sprawdź, czy działa
W API Keys utwórz nowy klucz. Zapisz go — nie pojawi się ponownie. Pamiętaj: ten klucz służy narzędziom do dostępu do OmniRoute, a nie do upstreamowych providerów.
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
Powinieneś zobaczyć listę podłączonych modeli.
Krok 5: Skieruj IDE lub CLI na OmniRoute
W swoim IDE lub narzędziu CLI ustaw:
Base URL: http://localhost:20128/v1
API Key: [skopiuj z Dashboard → Endpoints]
Model: auto
To wszystko! Twoje IDE korzysta teraz z OmniRoute z automatycznym wyborem providera.
Przykład IDE: VSCode/Continue.dev
- W VSCode zainstaluj rozszerzenie Continue.dev.
- Zaktualizuj
~/.continue/config.yaml, dodając następujące linie:
- name: OmniRoute - Auto
provider: openai
model: auto
apiBase: http://localhost:20128/v1
apiKey: <YOUR_KEY>
- W panelu czatu Continue.dev wybierz
OmniRoute - Auto— żądania będą szły do OmniRoute. - (Opcjonalnie) Ćwiczenie dla czytelnika — niech Twoje IDE uzupełni
config.yamlo pozostałe gotowe konfiguracje 😊
Przykład CLI: Codex CLI
- Ustaw trwale zmienną środowiskową w systemie operacyjnym.
Na macOS/Linux (dodaj do
~/.bashrclub~/.zshrc):
export OMNIROUTE_API_KEY="<YOUR_KEY>"
Dla Windows (Command Prompt):
setx OMNIROUTE_API_KEY <YOUR_KEY>
- Uruchom Codex skonfigurowany pod OmniRoute. Wpisz:
omniroute launch-codex --model auto
Możesz to zrobić ręcznie przez codex i parametry wiersza poleceń wskazujące endpoint oraz klucz API, ale powyższa komenda sprawia, że OmniRoute zajmuje się wszystkim za Ciebie.
- CLI powinno teraz wysyłać żądania do OmniRoute.
Potwierdź, że narzędzie routuje przez OmniRoute
Szczegóły żądania zobaczysz, klikając Monitoring/Logs na lewym pasku bocznym. Kliknięcie wpisu pokazuje więcej szczegółów. Przy okazji zobaczysz, jakie informacje wysyła Twój ulubiony harness — przydatne edukacyjnie i przy debugowaniu.
Co dalej?
- Auto-Combo Guide — Pozwól OmniRoute wybrać najlepsze AI za Ciebie
- Providers Guide — Podłącz więcej providerów (darmowych i płatnych)
- Free Tiers Guide — Darmowe AI bez karty kredytowej
- Troubleshooting — Rozwiązywanie typowych problemów
Częste pytania
„Czy potrzebuję klucza API?"
Nie! Możesz korzystać z darmowych providerów (Kiro, OpenCode Free, Pollinations) bez żadnego klucza API. Wystarczy podłączyć je w dashboardzie.
„Czym jest auto?"
auto każe OmniRoute automatycznie wybrać najlepszego providera dla każdego żądania. Uwzględnia szybkość, koszt, jakość i dostępność. Szczegóły w Auto-Combo Guide.
„Ile to kosztuje?"
Sam OmniRoute jest darmowy i open-source. Płacisz tylko za providerów, z których korzystasz. Wiele ma darmowe limity — zobacz Free Tiers Guide.
„Czy działa z Claude Code / Cursor / Copilot?"
Tak! OmniRoute działa z każdym narzędziem obsługującym format OpenAI. Ustaw base URL na http://localhost:20128/v1. Konkretne instrukcje znajdziesz w CLI Tools Guide.
„Co jeśli provider padnie?"
OmniRoute automatycznie pomija niedziałających providerów i próbuje kolejnego. Nic nie musisz robić. Szczegóły w Auto-Combo Guide.
Potrzebujesz pomocy?
- Troubleshooting — Typowe problemy i rozwiązania
- Discord — Wsparcie społeczności
- GitHub Issues — Zgłaszanie błędów