Installation¶

This page gets the astra CLI installed and verified. From there, getting started takes you from scaffold to a validated analysis in about ten minutes.

If you'd rather see the schema first, jump to the specification.

Install¶

We recommend installing with uv — Astral's fast Python package and project manager. If you don't have uv yet, follow the official installation instructions (one-line install on macOS, Linux, and Windows).

uv (recommended)pipFrom source

uv tool install astra-tools

pip install astra-tools

git clone https://github.com/LightconeResearch/ASTRA.git
cd ASTRA
uv pip install -e ".[dev]"

Verify the install:

astra --version
astra --help

Next: getting started¶

Getting started is the tour of the format itself: scaffold a project, edit the analysis, validate it, inspect it, define universes, and attach evidence.