Skip to main content
The ARC-AGI Toolkit is an open-source Python SDK for ARC-AGI-3 environments, geared towards researchers looking to make progress on ARC-AGI-3. The Toolkit enables:
  • Local development — Run your agents locally without needing the API, built on top of the ARC-AGI-3 game engine
  • Customization — Edit existing games and create new ones
  • Flexibility — Interact with environments locally or via API

​
QuickStart

​
1. Install the Toolkit

uv add arc-agi
# or
pip install arc-agi

​
2. Set your API key (optional)

export ARC_API_KEY="your-api-key-here"
If no key is provided, an anonymous key will be used. See API Keys for more details.

​
3. Play a game

import arc_agi
from arcengine import GameAction

arc = arc_agi.Arcade()
env = arc.make("ls20", render_mode="terminal")

# See available actions
print(env.action_space)

# Take an action
obs = env.step(GameAction.ACTION1)

# Check your scorecard
print(arc.get_scorecard())

​
Next Steps

​
Changelog

​
[0.9.3] - 2026-03-09

​
Added

  • OperationMode.COMPETITION method, see Documentation
  • Official Scoring
    • Average for an individual games is now weighted by the level index (1 indxed)
    • Score for an individual level is now squared. A score of 0.5 now becomes 0.25

​
Fixed

  • Continued fixes for 404 Scorecard not found

​
[0.9.2] - 2026-02-26

​
Added

​
Fixed

  • 404 Scorecard not found about 50% of the time when in ONLINE mode
  • Game source being downloaded even if local copy already exists

​
[0.9.1] - 2026-01-29

Initial Release