Darwin for developers

Everything you need to run Darwin, script it, and plug it into your own agents. Darwin is self-hosted, so there is no signup: you bring your own provider keys, or none at all in offline mode.

Quickstart

# Homebrew (macOS, Linux)
brew tap karthiksubramanian07/darwin https://github.com/KarthikSubramanian07/Darwin
brew install trydarwin

# or pipx, straight from the GitHub release
pipx install https://github.com/KarthikSubramanian07/Darwin/releases/download/v0.1.0/trydarwin-0.1.0-py3-none-any.whl

darwin --offline        # evolves an agent with no keys and no network

Hacking on Darwin itself? Clone the repository and run pip install -e ".[all]" instead. The [all] extra adds the optional Daytona, Braintrust, and autoevals SDKs; the base install runs fully offline without them.

The offline run uses a local sandbox, a local scorer, and canned mutations, so it is deterministic and free. The output ends with the fitness curve, the champion genome, and the path of the saved run record.

CLI

The trydarwin package puts two commands on your PATH:

Both are also available as modules: python -m darwin.main and python -m darwin.server.app.

Local API

The server binds to loopback. If you expose it, set DARWIN_API_TOKEN and send Authorization: Bearer <token> on POST /api/run and WS /ws.

API keys and configuration

Darwin does not issue API keys. Copy .env.example to .env and add keys only for the integrations you want, then flip their feature flags:

Sandbox environment

Offline mode is the sandbox: it exercises the full loop with no keys, and CI runs the entire test suite this way. For a visual sandbox, the homepage replays a recorded evolution and the Lab replays a recorded model race.

When to use Darwin

Reach for Darwin when the job is to find the best agent configuration for a specific, measurable task, not to answer a one-off question. Good fits:

Poor fits: tasks with no way to score an answer, real-time chat, or anything that needs a hosted API (Darwin is self-hosted).

How an agent should use Darwin