Quickstart

Lucid Train is a single-binary coding agent for your terminal. It runs frontier open-source models locally via Ollama, or any model through OpenRouter. This guide gets you from zero to your first task in a minute.

1. Install

The recommended install is the pip wheel · it ships the compiled binary, no Python or Rust toolchain needed:

shell
$ pip install lucid-train

Prefer something else? See all install methods · pipx, uv, cargo, curl | sh, Homebrew, and winget.

2. Launch

shell
$ lucid-train

On first run you'll see a setup screen that detects your hardware. You have two paths · and you need no API key for the local one:

3. Give it a task

Just describe what you want. The agent reads the repo, plans, edits files (shown as diffs), runs commands, and verifies its work:

shell
› fix the failing auth test and run the suite

Headless / CI

Run a single task non-interactively and exit with a status code:

shell
$ lucid-train exec "add a healthcheck endpoint" -m gpt-oss:20b

Modes

Next steps