athanor-ai
Lean 4 proof verification as agentic training signal.
Turn formal proofs into reward functions. Score agent output with compilers, not judges.
athanor-ai.com
Your agent writes code. Then it writes a proof that the code is correct. The Lean 4 compiler checks the proof. The result is a training signal with no ambiguity.
import athanor
# Verify a Lean 4 proof
result = athanor.verify_proof("""
theorem add_comm (a b : Nat) : a + b = b + a := by
omega
""")
print(result.compiles) # True
print(result.has_sorry) # False
print(result.score) # 1.0
Install
pip install athanor-ai
What this solves
You have domain expertise. You know what correct code looks like. You want an AI agent to produce verified solutions, not guesses.
The problem: LLM judges are noisy. Unit tests are brittle. Benchmarks don't produce training signal.
The solution: Lean 4 formal proofs are deterministic, machine-checked, and produce continuous reward signal (full proof = 1.0, partial = 0.35, broken = 0.25).
Verify proofs
Check if a Lean 4 proof compiles. Detect sorry placeholders. Catch banned constructs (axiom, import Mathlib, unsafe).
from athanor import verify_proof, check_sorry, score_proof
# Full verification with detailed result
result = verify_proof(proof_code)
result.compiles # did it compile?
result.has_sorry # any incomplete proof markers?
result.sorry_count # how many sorry placeholders?
result.score # 0.0 - 1.0
result.status # "full_proof" | "partial_proof" | "compile_error" | "banned"
result.errors # compiler error messages
# Quick score (just the float)
score = score_proof(proof_code) # 1.0, 0.35, 0.25, or 0.0
# Check for sorry without full compilation
has_sorry, count = check_sorry(proof_code)
Works with local Lean 4 installation or via Docker (ghcr.io/leanprover/lean4).
Score agent output
Pair code with a proof. Score both. Use the result as reward.
import athanor
env = athanor.make("my-environment", task="my-task")
env.reset()
result = env.score({
"kernel.py": agent_code,
"proof.lean": agent_proof,
})
# Scoring layers:
# 1. Does the code work? (verifier checks)
# 2. Does the proof compile? (Lean compiler)
# 3. Is the proof complete? (no sorry)
print(result.score) # combined score
print(result.lean_status) # proof status
Agent retry with verifier feedback
Agent gets the scoring output and tries again. No human in the loop. The verifier feedback is the teacher.
results = env.run(
model="anthropic/claude-sonnet-4-6",
api_key="...",
max_retries=3,
target_score=0.95,
)
# Attempt 1: 0.35 (code correct, proof has sorry)
# Attempt 2: 0.72 (proof compiles, 2 sorry remaining)
# Attempt 3: 0.98 (full proof, verified)
RL training
Use proof scores as reward signal in any RL framework.
from trl import PPOTrainer
env = athanor.make("my-environment")
trainer = PPOTrainer(
reward_fn=lambda completions: env.reward_fn(completions),
...
)
Compatible with TRL, veRL, NeMo-RL, or any custom training loop.
Proof scoring
proof_multiplier:
1.00 full proof (compiles, no sorry)
0.35 partial proof (compiles with sorry)
0.25 broken proof (does not compile)
0.15 no proof submitted
0.00 banned construct (axiom, Mathlib, unsafe)
Partial proofs produce gradient. An agent that proves 4 of 7 theorems scores higher than one that proves 0. This is the training signal.
Getting environments
The verify_proof and score_proof functions work standalone with any Lean 4 code. For full environment scoring (code + proof + property tests), contact athanor-ai.com.
Requirements
- Python >= 3.9
- Lean 4 or Docker (for proof verification)
License
Apache-2.0
Metadata
Release files for athanor-ai 0.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| athanor_ai-0.3.1.tar.gz | 53.6 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| athanor_ai-0.3.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 94.2 kB
Release files / athanor_ai-0.3.1.tar.gz
| Download URL | athanor_ai-0.3.1.tar.gz |
|---|---|
| Size | 53.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
40896cc609e2cf0b82c3f3fcc3400e8a33995abec258c3536b25abf8ef0262ee
|
|
BLAKE2b-256 checksum How to use checksums |
f636451cea4e76cb00b0d8cb9f0b972f2816ef006a2f42d9600bde213239e12b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.12
|
Release files / athanor_ai-0.3.1-py3-none-any.whl
| Download URL | athanor_ai-0.3.1-py3-none-any.whl |
|---|---|
| Size | 40.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
660e48a128deaeee8877eed7e450c900c81fb32dd103cefcbe3b256dd4eb6a71
|
|
BLAKE2b-256 checksum How to use checksums |
d3af78f7ea7638fddaf21ccae509d3a72d6abf49522ab607391f93d4ac9860ff
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.12
|
Security for athanor-ai 0.3.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.