ARC-AGI / itt_solver /README.md
rogermt's picture
Fix #8: Rename README.md.md to README.md in itt_solver/
f1434cc verified
# ARC-AGI Reproduction Project
**Project goal**
Recreate the system described in *A Pre-Emergence Mechanics Framework for Solving the Abstraction and Reasoning Corpus ARC-AGI* by Achilles. The codebase implements a boundary constrained field solver (Intent Tensor Theory substrate) and a beam search driver to propose transforms that reduce L1 residue against ARC tasks.
**Current status**
- Core driver `itt_solver/experiment_driver.py` runs experiments and saves artifacts to `experiments/`.
- Runs complete and save `*_phi_best.npy`, `*_logs.json`, `*_result.json`.
- Immediate blockers discovered and addressed: W&B recursion removed; logging lacked candidate arrays; some transforms were no-ops. Diagnostics and small patches are in `experiments/` and `itt_solver/` to inspect and fix behavior.
- Smoke tests show the beam accepts candidates but residue has not decreased for the example task. See `experiments/` for logs.
**Quick start minimal run**
1. Install dependencies (if not present): `numpy`, `matplotlib`.
2. From project root run a single job in a notebook cell:
```python
from itt_solver.experiment_driver import default_atomic_factory, run_single
# build task and params (example provided in repo)
res = run_single(task, default_atomic_factory(params, task), params, out_dir="experiments")
print(res)
```