The Lightcone Research Stack is Lightcone Research's
tooling for research analyses described with ASTRA
(Agentic Schema for Transparent Research Analysis). You describe an analysis in an
astra.yaml specification; the stack validates it and takes care of the rest —
execution, environments, and provenance.
→ Read the documentation at https://docs.lightconeresearch.org
- Install — uv, git, and the
lccommand - Getting started — your first analysis, from
lc initto a published result - Core concepts — projects, output identity, and how provenance is recorded
- Running on a cluster — SLURM, containers on HPC, and parallel filesystems
- Troubleshooting — common errors and how to fix them
| Component | What it does | Repository |
|---|---|---|
| lightcone-cli | The lc CLI: project scaffolding, locked environments, sandboxed execution, and the provenance layer |
LightconeResearch/lightcone-cli |
| astra-tools | The SDK and astra CLI for ASTRA specifications: schema, validation, and evidence verification helpers |
LightconeResearch/astra-tools |
The stack is in early alpha, and bug reports, design challenges, and use cases it doesn't cover yet are welcome. Report a problem with a tool on that tool's repository; report a problem with the documentation itself — a page that is wrong, unclear, or out of date — here.
BSD 3-Clause — see LICENSE.