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

​

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

• listen_and_serve method, see Documentation

​

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