rome-os / rome

Rome 
 A compounding agent OS for recursive agents. 
 Website 
 ·
 Try Rome Cloud 
 ·
 Documentation 
 ·
 App Store 
## What is Rome?
Most progress in AI comes from scaling models. Rome scales the other axis, the environment: the tools, workflows, memory, and interfaces an agent works within (why this matters).
Rome is a guardrailed environment where human and agent collaborate, and the collaboration compounds. Agents build their own harnesses, design their own SOPs, and orchestrate workflows under your guidance. Proven capabilities stick. Every interaction raises the ceiling for the next.
Rome also works as an open source alternative to Grok Bot and Meta's Muse
for persistent agents, scheduled tasks, and custom apps.
## Get started
### Rome Cloud
Rome Cloud provisions a private Rome environment for each guardian. It is currently
available as a preview.
Join the preview →
### Run with Docker
One script checks for Docker, pulls the published image, and starts Rome:
 [code] 
Or clone the repository and run the script from it:
 [code] 
The dashboard comes up at `http://localhost:7663`, bound to loopback only.
First-run onboarding is open to whoever reaches it first, so exposing it
beyond the machine takes an explicit `--bind`. State lives in named Docker
volumes, so re-running the script upgrades the container without losing data.
Telemetry export stays off unless you set `OTEL_EXPORTER_OTLP_ENDPOINT`. Run
the script with `--help` for ports, profiles, and the other settings it
forwards.
Rome Docker images default to `PANTHEON_BASE_ORIGIN=https://romeos.cc`.
To use another Rome Cloud deployment, pass your origin when starting the container
with `docker run -e PANTHEON_BASE_ORIGIN=https://cloud.example.com` or set it in
the Compose `.env` file. Recreate the container after changing the value.
The quickstart script also accepts a shell override:
 [code] 
### Run the development environment
To run this repository from source, you need:
- Node.js 24 or newer
- Corepack and pnpm 11.6
- Docker with Docker Compose
From a checkout of this repository:
 [code] 
`pnpm dev:all` starts the production-shaped local stack: Rome, observability,
routing, and the web development server. It connects to `https://romeos.cc` by
default; set `ROME_DEV_PANTHEON_ORIGIN` to use another Rome Cloud deployment.
The script prints the local URLs and development credentials when startup completes.
This is the contributor development path, not the final production self-hosting
distribution. See `CONTRIBUTING.md` for how to report issues,
open pull requests, and get through code review, and `CLAUDE.md` for
the complete development loop, container commands, and validation requirements.
## Rome Apps
**Rome App is the new way to interact with your agent.**
Chat is a good place to ask for something once. Repeated work deserves a place of
its own: an inbox that remembers what was triaged, a code review loop you can
inspect, a price tracker that keeps watching, or a morning brief that arriv