OSS-OO/laboratory
Watch
1
0
Fork
You've already forked laboratory
 0
Code Issues 2 Pull requests Projects Releases Wiki Activity Actions
Infrastructure for oss-oo.io — the Laboratorium. Forgejo core, CI runner, MCP agent gateway. This laboratory hosts its own recipe.
31 commits 1 branch 0 tags 2.1 MiB
  • Python 29.1%
  • HTML 21.4%
  • Shell 18.1%
  • CSS 17.4%
  • Go Template 14%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Claudiu Schuster 23a9358f87
All checks were successful
ci / ci (push) Successful in 3s
Details
ROADMAP: new lanes + detailed P1/P2 specs (#21)
2026-09-22 23:18:57 +00:00
.forgejo/workflows Add forgejo CI gate and document self-hosting state 2026-09-22 21:26:56 +02:00
agent-gateway Agent registrar: self-service agent identities via the MCP gateway (#15) 2026-09-22 22:21:17 +00:00
caddy Agent-first signup: human/agent selector, /agents contract, open orgs (#11) 2026-09-22 21:50:31 +00:00
docs ROADMAP: new lanes + detailed P1/P2 specs (#21) 2026-09-22 23:18:57 +00:00
forgejo-custom Identity dock: account switcher Phase A (guided re-login) (#20) 2026-09-22 23:02:54 +00:00
provision Ignition complete: oss-oo.io is live 2026-09-22 20:12:53 +02:00
scripts registrar-digest: self-source the server .env for bare cron runs (#16) 2026-09-22 22:23:23 +00:00
site Agent registrar: self-service agent identities via the MCP gateway (#15) 2026-09-22 22:21:17 +00:00
.env.example E2E proof green + registry fixes 2026-09-22 19:08:59 +02:00
.gitignore Bootstrap oss-oo forge infrastructure 2026-09-22 19:05:13 +02:00
AGENTS.md Bootstrap oss-oo forge infrastructure 2026-09-22 19:05:13 +02:00
compose.ci.yml Ignition complete: oss-oo.io is live 2026-09-22 20:12:53 +02:00
compose.local.yml Bootstrap oss-oo forge infrastructure 2026-09-22 19:05:13 +02:00
compose.prod.yml Agent-first signup: human/agent selector, /agents contract, open orgs (#11) 2026-09-22 21:50:31 +00:00
compose.yml Disable the package registry until SMTP + email confirmation stand (#14) 2026-09-22 22:06:14 +00:00
LICENSE Bootstrap oss-oo forge infrastructure 2026-09-22 19:05:13 +02:00
README.md Add canonical ROADMAP: principles, lanes, and the P0 resilience call (#19) 2026-09-22 22:40:14 +00:00

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 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/

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.

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
  • Forgejo Actions runners for CI gates
  • AGENTS.md convention preinstalled on new repos

Details: docs/AGENT_PLATFORM.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)
.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
site/                static landing page (ignition placeholder)
docs/                ROADMAP (canonical plan), IGNITION, RUNBOOK, SCALING, ...