Fix #8: Rename README.md.md to README.md in itt_solver/
Browse files- itt_solver/README.md +20 -0
itt_solver/README.md
ADDED
|
@@ -0,0 +1,20 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# ARC-AGI Reproduction Project
|
| 2 |
+
|
| 3 |
+
**Project goal**
|
| 4 |
+
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.
|
| 5 |
+
|
| 6 |
+
**Current status**
|
| 7 |
+
- Core driver `itt_solver/experiment_driver.py` runs experiments and saves artifacts to `experiments/`.
|
| 8 |
+
- Runs complete and save `*_phi_best.npy`, `*_logs.json`, `*_result.json`.
|
| 9 |
+
- 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.
|
| 10 |
+
- Smoke tests show the beam accepts candidates but residue has not decreased for the example task. See `experiments/` for logs.
|
| 11 |
+
|
| 12 |
+
**Quick start minimal run**
|
| 13 |
+
1. Install dependencies (if not present): `numpy`, `matplotlib`.
|
| 14 |
+
2. From project root run a single job in a notebook cell:
|
| 15 |
+
```python
|
| 16 |
+
from itt_solver.experiment_driver import default_atomic_factory, run_single
|
| 17 |
+
# build task and params (example provided in repo)
|
| 18 |
+
res = run_single(task, default_atomic_factory(params, task), params, out_dir="experiments")
|
| 19 |
+
print(res)
|
| 20 |
+
```
|