JobPilot

🔌 Using OmniRoute with Job-Pilot

OmniRoute is a local, open-source AI gateway — one OpenAI-compatible endpoint (http://localhost:20128/v1) that routes across many providers with free-tier fallback. Job-Pilot connects to it like any other provider, so all the AI features (company/salary intel, résumé analysis, interview prep, salary coach, and the apply-kit drafts) work through it.

Configure it in Job-Pilot

The OmniRoute (local) preset is selected by default, so the sidebar already points at http://localhost:20128/v1 with model auto/best-free:

Job-Pilot sidebar configured for OmniRoute

The 🧪 Test connection button shows a ✅ only once OmniRoute is actually running and has at least one active provider — see the setup steps below.

Setup steps

  1. Install & run OmniRoute — its dashboard opens at http://localhost:20128.
  2. Providers → connect at least one (e.g. Kimi, DeepSeek, Gemini). The Provider Topology must show ≥ 1 active — a router with 0 active providers can’t answer.
  3. API Keys → Create a key.
  4. In Job-Pilot’s sidebar:
    • Choose the OmniRoute (local) preset (already the default).
    • Paste your key into API key.
    • Click 🔄 Load models → pick a model.
    • Click 🧪 Test connection — you should see ✅ and the model name.
sequenceDiagram
    participant JP as Job-Pilot
    participant OR as OmniRoute (:20128)
    participant P as Provider (DeepSeek / Kimi / …)
    JP->>OR: POST /v1/chat/completions (model = auto/best-free)
    OR->>P: routes to a healthy provider
    P-->>OR: completion
    OR-->>JP: OpenAI-shaped response

⚠️ Pick the right model (the #1 gotcha)

OmniRoute exposes namespaced model routes — there is no bare auto. Sending auto (or auto/best-chat) can fall through to a weak provider (e.g. felo-chat) that returns garbage like .com.

Use these ✅ Avoid these ❌
auto/best-free, auto/smart (route to DeepSeek) bare auto, auto/best-chat (→ felo-chat junk)

Use 🔄 Load models to see everything your OmniRoute exposes, and 🧪 Test connection to confirm a model actually replies before you rely on it. If output ever comes back as a fragment, Job-Pilot detects it and tells you to switch models. Some providers may return errors independent of Job-Pilot (e.g. Kimi 402 if billing is unset, occasional 502s) — just pick another working route.

Prefer zero setup?

If you don’t want to run a gateway, the Groq (free) preset is the fastest path: sign up at console.groq.com → API Keys, paste the key, done. Full provider table is in the main README.

This site is open source. Improve this page.