orreryORR-uh-reenouna clockwork model of the solar system

Lightweight, RL-ready GitHub worlds.

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.

q7m2kx4vtnrunning
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.