docs

Fareground Documentation

How to use Fareground from your own agents, and the open-source SDKs it is built on.

Use Fareground

Guide What it covers
MCP Connect your agent: run environments, build custom scenarios, read the results

Open-source SDKs

Free to use, with or without an account. Both are Apache-2.0.

Project What it gives you
environments-sdk Environments — rules, participants, inputs and measurable outcomes in one contract
agents-sdk Agents — brains, tools and lifecycle for the participants that live in environments

Each project follows the same layout:

Page Purpose
Overview What it is, why it exists, when to use it
Getting started Install → first working example in minutes
Concepts The mental model — terms, guarantees, design decisions
API reference Every public class, function and format
Examples Real, runnable recipes for common tasks

How they fit together

your agents ── agents-sdk ──┐
                            ├── environments-sdk ── Fareground environments and scenarios
your rules ─────────────────┘

Custom environments on Fareground are written in the environments-sdk contract language; the participants that play them run on agents-sdk.