Get Scorecard - ARC-AGI-3 Docs

Overview

After playing games, you can retrieve your scorecard to see aggregated performance results. The Toolkit automatically manages a default scorecard, or you can create and manage your own.

Getting the Default Scorecard

The Toolkit automatically creates a scorecard when you start playing. Retrieve it with get_scorecard():

import arc_agi
from arcengine import GameAction

arc = arc_agi.Arcade()
env = arc.make("ls20", render_mode="terminal")

# Play the game
env.step(GameAction.ACTION1)

# Get your scorecard
scorecard = arc.get_scorecard()
if scorecard:
    print(f"Score: {scorecard.score}")
    print(f"Games played: {len(scorecard.games)}")

Scorecard Properties

The scorecard contains your aggregated results:

scorecard = arc.get_scorecard()

if scorecard:
    print(f"Score: {scorecard.score}")
    print(f"Games: {scorecard.games}")

See Full Scorecard

To view the complete scorecard with all fields, use model_dump_json():

scorecard = arc.get_scorecard()

if scorecard:
    print(scorecard.model_dump_json(indent=2))

Next Steps

Create Scorecard — Create a custom scorecard with tags
Close Scorecard — Finalize and close a scorecard
Learn about scoring methodology