Praex

---

Praex is an open source (MIT) AI coding agent for the terminal. It reads your codebase, edits files, runs commands, and keeps sessions you can come back to. Use it with your own key for any major provider or with a model running on your own machine. No Praex account is needed for either.

Install

curl -fsSL https://praex.ai/install.sh | bash

Prebuilt binaries for Linux x64 and macOS (Apple Silicon and Intel), with SHA256 checksums, are also on the Releases page.

Use your own key

Set the provider's usual environment variable and start Praex:

export ANTHROPIC_API_KEY=...   # or OPENAI_API_KEY, GEMINI_API_KEY, OPENROUTER_API_KEY, ...
praex

Or store a key with praex auth login. Works with OpenAI, Anthropic, Gemini, Groq, DeepSeek, Mistral, OpenRouter, xAI, and any OpenAI-compatible endpoint. praex models lists what is available. Usage with your own key is unlimited and free.

Local models

Point Praex at Ollama, LM Studio, llama.cpp, vLLM or any other OpenAI-compatible server. Put this in praex.json in your project (or in ~/.config/praex/praex.json for every project):

{
  "$schema": "https://praex.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": { "baseURL": "http://localhost:11434/v1" },
      "models": { "qwen3-coder:30b": { "name": "Qwen3 Coder 30B" } }
    }
  }
}

Praex hosted models (optional)

Praex also runs hosted models we post-train and serve on our own GPUs. Sign in with praex login to use them:

Tier	Model	Plan
Velox	fast daily driver	Free
Faber	heavier coding and reasoning	Pro
Lucia	frontier-class flagship	Max

No nannying. Praex models answer the question without moralizing, lecturing, or refusing legitimate work. There is a hard floor for genuinely dangerous content, and nothing else.

Highlights

• TUI built for real work: folded tool output, sessions, themes
• Permission modes · manual approval by default, loosen when you trust it
• Headless runs · praex run "fix the failing test" for scripts and CI, praex serve for a local server
• /rc · Remote Control: keep a session running here and continue it from your phone or the web (Praex account)
• Web search on hosted tiers, permission-gated per query
• Memory · persistent per-user memory across sessions

Build from source

Requires Bun.

bun install
cd packages/opencode
bun run script/build.ts --single
./dist/opencode-linux-x64/bin/opencode --version

Built on OpenCode

Praex is a fork of OpenCode (MIT). We keep its excellent agent core, including support for every provider above, and add our own work on top: stricter permission checks for destructive commands, an agent loop that carries on when a step stalls, a self-check after headless runs, Remote Control (/rc), persistent memory, and optional hosted Praex models. Upstream attribution is preserved in LICENSE and THIRD-PARTY-NOTICES.md.

License

MIT