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.9] - 2026-06-10

​

Updated

• Remote action failures now include the HTTP response body in error logs

​

[0.9.8] - 2026-04-17

​

Fixed

• Full game resets occurring in competition mode

​

[0.9.7] - 2026-04-14

​

Updated

• Increased the per-level score cap from 100% to 115% and capped each game by the weighted maximum for its completed levels

​

Fixed

• Memory leaks related to dynamically loaded game code and GUID mismatches

​

[0.9.6] - 2026-03-21

​

Fixed

• Scoring updates after a command was received in the GAME_OVER state

​

[0.9.5] - 2026-03-19

​

Fixed

• Scorecards not updating when ONLY_RESET_LEVELS was set

​

[0.9.4] - 2026-03-10

​

Added

• include_frame_data parameter for make() and listen_and_serve()

​

[0.9.3] - 2026-03-09

​

Added

• OperationMode.COMPETITION method, see Documentation
• Official Scoring
  • The average for an individual game is now weighted by the level index (1-indexed)
  • 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