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

Local

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")
AdvantagesLimitations
~2,000 FPS (120,000 frames per minute)No online scorecards
No rate limitsNo shareable replays
Run as many instances as you want
No API key required

Online

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")
AdvantagesLimitations
View scorecards onlineRequires API key
Shareable replaysCapped at 600 requests per minute
Results appear on leaderboard

Learn More

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