Run with Docker

If you would rather not install anything, run Orchard from a container. The image ships with the orch command and nothing else, so it stays small and starts fast. This suits CI and servers well.

Run the CLI

$docker run --rm ghcr.io/artemis-inc/orchard:latest --version

Run an agent in the current folder

Mount your working directory and run a program inside the container.

$docker run --rm -v $PWD:/work -w /work ghcr.io/artemis-inc/orchard run agent.orch -t 'hello'

Pass your model API key through with -e when you point the agent at a real provider, for example -e ANTHROPIC_API_KEY.

Pin a version

Use a version tag instead of latest for reproducible runs.

$docker run --rm ghcr.io/artemis-inc/orchard:3.1.0 --version
Where the image lives. Images are published to the GitHub Container Registry alongside the project. The build that produces them is part of the release pipeline, so each tagged version has a matching image.