- Python 74.4%
- TypeScript 22.3%
- JavaScript 1.9%
- Shell 0.9%
- CSS 0.3%
- Other 0.2%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| .claude | ||
| .forgejo/workflows | ||
| .osf | ||
| deploy | ||
| docs | ||
| openspec | ||
| sim | ||
| src/osf | ||
| tests | ||
| tools | ||
| ui | ||
| .dockerignore | ||
| .gitignore | ||
| AGENTS.md | ||
| CLAUDE.md | ||
| Dockerfile | ||
| LICENSE | ||
| pyproject.toml | ||
| README.md | ||
| uv.lock | ||

🚧 Beta - still under heavy development 🚧
Deploy with Docker
You need Docker with Compose, and a Forgejo account with an access token (repository, issue and user: read and write).
git clone https://forgejo.underthere.xyz/cmoriarty/braid.git
cd braid
docker build -t braid:latest .
Create deploy/.env:
BRAID_IMAGE=braid:latest
OSF_FORGEJO_URL=https://your-forgejo.example.com
OSF_FORGEJO_TOKEN=<your token>
OSF_UI_BASE_URL=http://<this host> # where pull requests link back to
OSF_UPSTREAM_URL=http://<model host>/v1 # optional: a local OpenAI-compatible model server
Then start it:
docker compose -f deploy/docker-compose.yml up -d
Open http://<this host>. curl http://<this host>/api/status reports "ready" when it is up.
Braid has no login: anyone who can reach the port can start runs and approve gates. Keep it on a private network.
Free-model provider keys and the other optional settings are listed in
deploy/.env.example.
Get started
1 · Pick a backend
Your own model server, a paid API such as Anthropic, or Free, which spreads steps across free model APIs.
2 · Choose a graph
New Run asks for a repository and a pipeline. thorough explores, proposes, reviews, builds, tests and opens a pull request.
3 · Start from an issue
Pick an open issue, or describe a feature in your own words.
4 · Approve the gates
The run stops where your judgement counts. Read the diff, then Approve or Request changes. Turn on auto-approve to let it run to a merged pull request on its own.
Acknowledgements
Braid stands on the shoulders of these open-source projects.
| OpenSpec | Spec-driven changes; openspec validate checks every proposal |
| opencode | The agent runtime: each step drives an opencode session |
| GoModel | The router behind the Free backend, spreading steps across free model APIs |
| Forgejo | Issues in, pull requests out |
| Qwen · vLLM | Open-weight models, served on your own hardware |
| Playwright | The browser a judge opens a UI change in |
| Starlette · Uvicorn · HTTPX | The server, its API and its calls out |
| SQLite | The run log |
| uv | Python packaging and the image's build |
| React · Vite · Tailwind CSS · virtua | The console |
| JetBrains Mono · IBM Plex | The console's typefaces |
