Skip to main content

BYOK Setup

Jorv is BYOK at every tier — Bring Your Own Keys. You connect your AI provider API keys directly; Jorv calls the providers under your key and never proxies, stores, or marks up the inference. The predictable cost is your provider bill plus a flat Jorv per-seat licence.

This page covers which keys you need, where to get them, and how to add them.

Required key

Anthropic (the Brain)

The Brain runs on Claude — Opus by default. You need at least an Anthropic key.

  1. Sign up at console.anthropic.com
  2. Create an API key under Settings → API Keys
  3. In Jorv Builder: Settings → AI Models → Anthropic → Add key

See Anthropic integration for advanced options (organisation IDs, custom base URLs, model preferences).

Optional keys

OpenAI (Voice + drones + classifiers)

OpenAI keys unlock:

  • Whisper STT — voice input via ⌘⇧M / Ctrl⇧M push-to-talk
  • OpenAI TTS — Brain responses spoken back
  • GPT-5 / 5.1 — alternative drone model for parallel workers
  • Haiku-equivalent classifiers — triage workloads

Get a key at platform.openai.com. Add via Settings → AI Models → OpenAI. See OpenAI integration.

ElevenLabs (premium voice)

For higher-fidelity TTS playback. Pick a voice ID + stability/similarity settings in Settings → AI Models → ElevenLabs. See /docs/voice.

Google Gemini (drones + media)

Gemini 2.5 Pro is supported for drone workloads. Image generation via Imagen 4. Add via Settings → AI Models → Gemini.

Ollama (local-only fallback)

Run open models locally — Llama, DeepSeek, Qwen. Useful for offline drone workloads, classifiers, or strict-air-gap environments. See Ollama integration.

Quality vs cost preference

In Settings → AI Models → Quality Preference, you pick how aggressively Jorv Builder optimises for cost vs quality:

  • 0 (Quality First) — Always use the most capable model for each task. Brain on Opus, drones on Opus/Sonnet, classifiers on Haiku.
  • 20 (Recommended default) — Brain on Opus, drones on Sonnet, classifiers on Haiku.
  • 50 (Balanced) — Brain on Sonnet, drones on Haiku-class, more aggressive caching.
  • 100 (Cost First) — Smallest viable model per task; aggressive caching; local fallback where possible.

The Brain itself is always pinned to the highest-quality model your preference allows.

How costs work

You pay each provider directly, billed against your account with them. Jorv never sees the provider bill and never marks up tokens.

Typical token economics (Solo tier, mixed usage):

  • Brain on Opus: $0.05-0.20 per substantial feature
  • Drones on Sonnet (when used): $0.10-0.40 per drone-army
  • Classifiers on Haiku: $0.001-0.005 per classification

See BYOK Calculator for an interactive comparison.

Corporate-BYOK (Enterprise tier)

Enterprise-tier customers can use Corporate-BYOK admin tooling to centrally manage keys across multiple seats:

  • Issue per-user provider keys from a corporate provider account
  • Rotate keys without per-user action
  • See per-user provider spend in the admin dashboard
  • Enforce per-seat token caps

See /builder/enterprise.

Troubleshooting