GET STARTED
Quickstart
Install Theoria-CLI, set up Lean and Mathlib, and prove a first theorem.
1. Install#
curl -fsSL https://www.theoria.sh/install/cli.sh | bash
theoria versionIf ~/.local/bin is not on your PATH, the installer prints the line to add to your shell profile.
2. Start Theoria and create a project#
mkdir -p ~/research && cd ~/research
theoria/new-project "Goldbach conjecture"A project's type (mathematics, theoretical physics, AI/ML, quantitative finance, other) decides which commands it gets. Mathematics and physics projects get the Lean workflows. See /project.
3. Set up Lean and Mathlib#
/lean install # clone a Mathlib release and fetch its build cache (about 7 GB)
/lean config # choose the Mathlib version for this project
/lean search install # Mathlib search: Loogle, Lean Finder and local searchLean comes from elan; install it first if lean --version does not work. How Theoria shares one Mathlib build across projects is explained in Lean environments.
4. Connect a model#
Theoria runs on the Pi coding agent. With AWS credentials it starts on Amazon Bedrock; otherwise use /login for a provider account, or set an API key, then /model to choose.
5. Formalize and prove#
/formalize every finite group of prime order is cyclic --name prime_order_cyclic
/prove formal/PrimeOrder.lean prime_order_cyclicEach workflow ends with a verdict from Lean: the statement unchanged, no sorry, only standard axioms. Ask in plain language too, and the agent starts the right workflow. Every form of these commands is in Slash commands.
6. Explore what is next#
/next-steps 2401.01234 --n 5
/help