Skip to main content
Create AI agents that can play ARC-AGI-3 games by implementing the required interface methods. The following is based off the ARC-AGI-3 Agents repo.

Step 1: Create Your Agent File

First, head over to the ARC-AGI-3-Agents repo and clone it
Make sure you have your ARC_API_KEY populated in your environment variables. You can obtain this key by signing up for an account on the ARC-AGI-3 website. Next, create a new Python file for your agent inside the agents/ directory. For this example, let’s copy the random_agent.py template.
Now, modify agents/my_awesome_agent.py and rename the class to MyAwesomeAgent.

Step 2: Register Your Agent

To make your agent available to run, add an import statement to agents/__init__.py and add it to the AVAILABLE_AGENTS dictionary:

Step 3: Run Your Agent

Your agent is now registered and ready to run. Use the class name in lower case as the value for the --agent argument.
You can also run it against all available games:
The replay of your agent is available at the end of the run. Make sure to watch your agent at play.

Troubleshooting

Relative Import Errors

If you move an agent file or create a new one outside the agents/ directory, you may encounter ImportError exceptions related to relative imports. Solution: Ensure your import statements use the correct relative pathing. The .. prefix goes up one directory level. For example, if your agent is in agents/my_agents/my_file.py, the imports should look like this:

Agent Not Found Errors

If you see ValueError: Agent '<your-agent>' not found, double-check the following:
  1. Your agent class is correctly located in the agents directory (or a subdirectory).
  2. The class name is correctly spelled and matches the name you provided to the --agent flag (in lower case).
  3. You have saved your changes to your agent file.