What a world is
A one-to-one replica of GitHub's external surface, designed for RL.
Every world carries GitHub's external surface, including REST, GraphQL, git, OAuth, and webhooks. Agents and applications talk to GitHub's API, while you manage the world through a control plane responsible for snapshots, forks, restores, and diffs.
One to one with GitHub
The same routes, payloads, status codes, and errors as GitHub, across REST, GraphQL, git over HTTPS, the OAuth web flow, GitHub Apps, and webhooks.
GET https://q7m2kx4vtn.tmp.orrery.host
/api/v3/repos/alice/app/pulls
Lightweight
A world is simply a directory with an SQLite database in a single process. A fresh copy for every rollout takes milliseconds and almost no disk.
POST /worlds
{"kind": "temporary",
"source": {"world": 41, "snapshot": "start"}}
Ready for RL
Every change to a world can be replayed exactly, driven deterministically by the world's clock, so every snapshot can be restored.
POST /worlds/41/snapshots/start/restore
POST /worlds/41/diff {"from": "start"}
Connect an app
Point anything that speaks GitHub at a world.
A world serves GitHub's own hosts and URLs, or a GitHub Enterprise Server's at an address of its own, so code written for either works against it unchanged. Issue a token for one of its actors, and your agent, bot, or CI integration can't tell the difference.
GITHUB_BASE_URL=https://q7m2kx4vtn.tmp.orrery.host GITHUB_API_URL=https://q7m2kx4vtn.tmp.orrery.host/api/v3 GITHUB_TOKEN=orrfake_… # an actor's token, from the world's control plane # git works too git clone https://q7m2kx4vtn.tmp.orrery.host/alice/app.git
Accounts are by invitation.
Orrery Cloud hosts worlds for training, evaluating, and testing agents that work on GitHub. The engine itself is source-available: download it and serve a world from one directory on your own machine.