Local vs Online

Choose how you want to run ARC-AGI-3 games.

Local (Recommended)

Fast, no rate limits, run many instances

Scorecards, replays, requires API key

Run games locally using the ARC-AGI engine. This is the recommended approach for development and testing.

from arc_agi import Arcade, OperationMode

arc = Arcade(operation_mode=OperationMode.OFFLINE)
env = arc.make("ls20", render_mode="terminal")

Advantages	Limitations
~2,000 FPS (120,000 frames per minute)	No online scorecards
No rate limits	No shareable replays
Run as many instances as you want
No API key required

Run games via the API to get scorecards and replays.

from arc_agi import Arcade, OperationMode

arc = Arcade(operation_mode=OperationMode.ONLINE)
env = arc.make("ls20", render_mode="terminal")

Advantages	Limitations
View scorecards online	Requires API key
Shareable replays	Capped at 600 requests per minute
Results appear on leaderboard

For all operation mode options and configuration details, see operation_mode in the Toolkit reference.