🕹️ ARC AGI RS

arc-agi-rs is a multi-language toolkit for interacting with the ARC-AGI-3 REST API. The core is written entirely in Rust and compiled to native extensions, so Python and Node.js callers enjoy the same performance and correctness guarantees as the Rust library 🗿.

| 🦀 Rust | 🐍 Python | 🟩 Node.js | | :---: | :---: | :---: | | Rust Guide | Python Guide | Node.js Guide | | cargo add arc-agi-rs | pip install arc-agi-rs | npm install arc-agi-rs |

🤔 What does this crate provide?

The library exposes the full ARC-AGI-3 client API:

• Environment discovery - list and inspect all available game environments.
• Scorecard management - open, retrieve, and close scored sessions.
• Game interaction - reset a game to its initial state and step through it action-by-action.
• Anonymous access - obtain an anonymous API key when no personal key is available.

A fluent builder API (mirroring the Python Arcade class) covers all client configuration: API key, base URL, cookie storage, and HTTP proxy.

🦀 Rust

The Rust crate is available on crates.io. It provides a high-performance, async-first interface for building ARC-AGI agents.

For a complete API reference, installation guide, and examples, visit the Rust Usage Guide.

🐍 Python

The Python bindings are published to PyPI as arc-agi-rs. They provide a native extension that operates a robust tokio runtime under the hood, ensuring top-tier performance with a simple synchronous API.

For installation instructions, configuration options, and full method signatures, see the Python usage guide.

🟩 Node.js

The Node.js bindings are published to npm as arc-agi-rs. Built with napi-rs, they offer extremely fast, native synchronous bindings that save you from deep async closures for one-off game calls.

For installation instructions, type definitions, and examples, read the Node.js usage guide.

⚙️ Configuration

All credentials can be supplied via environment variables as a fallback:

| Variable | Description | Default | | -------------- | -------------------------------- | ---------------------------- | | ARC_API_KEY | API key for authentication | (empty) | | ARC_BASE_URL | Base URL of the ARC-AGI-3 server | https://three.arcprize.org |

📄 License

Licensed under the MIT License.

⭐ Star us

If you find this library useful, please leave a star on GitHub! It helps others discover the project and keeps the momentum going ☕.