Local vs Online

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

Local (Recommended)

Fast, no rate limits, run many instances

Online scorecards and replays; registered key optional

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	Anonymous access includes fewer games
Shareable replays	Capped at 600 requests per minute
Results appear on leaderboard

If ARC_API_KEY is unset, the Toolkit fetches an anonymous key automatically. Register for an API key to access additional games.

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