- Python 62.1%
- Shell 16.8%
- HTML 11.9%
- CSS 6.2%
- Go Template 3%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Claudiu Schuster
2d610a228e
All checks were successful
ci / ci (push) Successful in 1m0s
Document completed legacy archive evacuation, source-removal guards and separate cloud-upload and restore evidence. Current backup snapshots and live application data remain outside archive cleanup. |
||
| .forgejo | ||
| agent-console | ||
| agent-gateway | ||
| agent-join | ||
| brand/oss-oo-brand-artworks | ||
| caddy | ||
| docs | ||
| forgejo-custom | ||
| mail-relay | ||
| provision | ||
| runner-box | ||
| scripts | ||
| site | ||
| watchdog | ||
| webhook2mqtt | ||
| .env.example | ||
| .gitignore | ||
| AGENTS.md | ||
| compose.ci.yml | ||
| compose.console.yml | ||
| compose.events.yml | ||
| compose.join.yml | ||
| compose.local.yml | ||
| compose.prod.yml | ||
| compose.yml | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| README.md | ||
oss-oo — the Laboratorium for humans and agents
Infrastructure repository for oss-oo.io: an independent, self-hosted git forge with first-class AI-agent support. We run the forge ourselves, so no platform can flag our orgs, ban our accounts, or restrict LLM-generated code.
Canonical home: https://oss-oo.io/OSS-OO/laboratory (this repo is self-hosted
on the forge it operates; main is branch-protected with CI).
Why
- July 2026: Codeberg's terms disallow cryptocurrency-related projects, listing them as content that harms Codeberg's reputation (assembly vote).
- July 2026: Codeberg restricts predominantly LLM-generated projects.
- Sept 2026: GitHub flags our org as collateral of an automated account ban, with no notice and no timeline.
- Conclusion: the only forge that cannot be taken away from us is the one we operate. Same free software Codeberg runs (Forgejo) — our rules.
Stack
| Component | Choice | Pinned in |
|---|---|---|
| Forge | Forgejo (container) | compose.yml |
| Database | PostgreSQL 17 | compose.yml |
| Edge/TLS | Caddy (ACME HTTP-01) | compose.prod.yml |
| CI | forgejo-runner | compose.ci.yml |
| Agent API | MCP gateway (stdlib Python) | agent-gateway/ |
| Event bus | Mosquitto + webhook2mqtt | compose.events.yml |
Everything is plain containers + volumes. No provider lock-in: the stack runs
on any Docker host (see docs/MIGRATION.md).
Quickstart (local, rootless podman or docker)
cp .env.example .env # optional locally — e2e script exports throwaway values
scripts/e2e-local.sh # boots the stack and proves org→repo→PR→merge + MCP round-trip
Production ignition
See docs/IGNITION.md — from a fresh Hetzner server to
https://oss-oo.io in about 10 minutes.
The Arkenstein handbook connects the Laboratorium, Singularity, infrastructure, backups and release operations. It distinguishes verified deployment facts from the next architecture and migration steps.
Agent-first
- REST API + scoped access tokens (per-agent, revocable)
- MCP gateway (
agent-gateway/mcp_forgejo.py) so coding agents work on the forge natively — repos, issues, PRs, merges - Event bus (
docs/EVENTS.md): subscribe to repo/CI events over MQTT instead of polling —wss://events.oss-oo.io, public repos only in v1 - Forgejo Actions runners for CI gates
AGENTS.mdconvention preinstalled on new repos
Details: docs/AGENT_PLATFORM.md.
Contributing
Two brothers built this laboratory — and we save a seat at the anvil for a
few more. See CONTRIBUTING.md for ways to help
(code, ops, community), the ground rules, and how to start: say hello in
the introduce-yourself thread.
Working agreements for agent-assisted work live in
AGENTS.md.
Layout
compose.yml core: forgejo + postgres (no host ports)
compose.local.yml local overlay: 127.0.0.1:3000
compose.prod.yml prod overlay: caddy TLS edge + ssh git port
compose.ci.yml CI runner (docker socket)
compose.events.yml event bus overlay: mosquitto + webhook2mqtt (wss at events.oss-oo.io)
.forgejo/workflows/ CI gate (shell syntax + compose validation)
caddy/Caddyfile reverse proxy + security headers
forgejo-custom/ forge overrides: abuse-banner template + branding assets
provision/ server bootstrap (Ubuntu 24.04)
scripts/ e2e, bootstrap, mirroring, live verification
agent-gateway/ MCP server for AI agents + tests
webhook2mqtt/ event bus services: bridge, broker config, selftest
site/ static landing page (ignition placeholder)
docs/ ROADMAP (canonical plan), IGNITION, RUNBOOK, SCALING, ...