rogermt commited on
Commit
f1434cc
·
verified ·
1 Parent(s): 26481e9

Fix #8: Rename README.md.md to README.md in itt_solver/

Browse files
Files changed (1) hide show
  1. 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
+ ```