ARC-AGI Toolkit Quickstart

• 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"

​

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

• Minimal Example — A complete script example
• List Games — Discover available games
• Local vs Online — Choose how to run games