{"id":27593,"library":"arckit","title":"arckit","description":"Tools for working with the Abstraction & Reasoning Corpus (ARC-AGI), including loading datasets (ARC-AGI-1, ARC-AGI-2), task manipulation, evaluation, and visualization. Current version: 1.0.1. Maintained regularly with releases.","status":"active","version":"1.0.1","language":"python","source_language":"en","source_url":"https://github.com/mxbi/arckit","tags":["arc-agi","abstraction-and-reasoning","dataset","evaluation"],"install":[{"cmd":"pip install arckit","lang":"bash","label":"Standard install"}],"dependencies":[],"imports":[{"note":"Common mistake: importing from arckit.data or arckit.util incorrectly; the main API is top-level.","symbol":"load_tasks","correct":"from arckit import load_tasks"},{"note":"Old import path; solve_one_task is now at top-level.","wrong":"from arckit.solve import solve_one_task","symbol":"solve_one_task","correct":"from arckit import solve_one_task"},{"note":"print_grid is in the vis submodule.","wrong":"import arckit.print_grid","symbol":"print_grid","correct":"from arckit.vis import print_grid"}],"quickstart":{"code":"from arckit import load_tasks, solve_one_task\n\n# Load tasks (defaults to ARC-AGI-2)\ntasks = load_tasks()\n# Or load ARC-AGI-1:\n# tasks = load_tasks('arc-agi-1')\n\n# Pick a training task\ntask = tasks[0]\n\n# Solve the first training pair with a dummy prediction\ndef dummy_solve(task):\n    # Return the second grid of the first pair\n    return task.train[0][1]\n\nresult = solve_one_task(task, dummy_solve)\nprint('Solved:', result)","lang":"python","description":"Loads ARC-AGI tasks and runs a dummy solver. Default dataset is ARC-AGI-2."},"warnings":[{"fix":"Use load_tasks('arc-agi-1') for original ARC-AGI-1 tasks.","message":"Default dataset changed from ARC-AGI-1 to ARC-AGI-2 in v1.0.1. Code relying on ARC-AGI-1 tasks must specify version string.","severity":"breaking","affected_versions":">=1.0.1"},{"fix":"Explicitly set topn=1 in evaluation functions if you need the old behavior.","message":"Default evaluation topn changed from 1 to 2 in v1.0.1, affecting metrics.","severity":"breaking","affected_versions":">=1.0.1"},{"fix":"Ensure solver returns a grid of same height/width as expected output for the test pair.","message":"solve_one_task expects a function that takes a dict task and returns a 2D list or numpy array. Returning incorrect shape silently may produce wrong metrics.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Run 'pip install arckit' in your active Python environment.","cause":"Package not installed or installed in wrong environment.","error":"ModuleNotFoundError: No module named 'arckit'"},{"fix":"Use 'from arckit import solve_one_task'.","cause":"Incorrect import of solve_one_task from a submodule that does not exist.","error":"AttributeError: module 'arckit' has no attribute 'solve'"},{"fix":"Upgrade arckit with 'pip install --upgrade arckit' to v1.0.1+.","cause":"Using an older version of arckit (<1.0.1) that does not support ARC-AGI-2.","error":"ValueError: Unknown dataset: 'arc-agi-2'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}