Skip to content

Install Crystal Lattice

The bundled Crystal Lattice CLI includes Python and the application runtime. You do not need a system Python installation or provider credentials to install it, start the terminal, or inspect the configured agents.

Choose an installation method

Your system Recommended method Guide
macOS Intel or Apple silicon Bash installer Install on macOS or Linux
Linux x64 or ARM64 Bash installer Install on macOS or Linux
Windows x64 or ARM64 Native PowerShell installer Install on Windows
Any supported system Download and inspect an immutable release archive Manual installation

Git Bash, MSYS2, and Cygwin provide an additional installer path on Windows x64. Native PowerShell is the recommended Windows method and the supported installer path on Windows ARM64.

Verify the command

After any installation method:

crystal-lattice --help

Start the terminal:

crystal-lattice --console

The default configuration can start without provider API keys. Missing optional credentials may produce configuration warnings, but they do not prevent normal startup.

Add API credentials when needed

Provider APIs require their real credentials when you send a request. Put those values in the .env file beside the active configuration instead of exporting them for normal use:

OPENAI_API_KEY=...
OPENROUTER_API_KEY=...
ANTHROPIC_API_KEY=...

For the complete lookup order, see Environment placeholders.

Source checkout

The bundled installers are intended for normal end-user installation. Contributors working from a checkout should use the source installation instructions.