opificia/factory

> **Early stage.** No usable release yet. We are building in the open.
What it is
Opificia is a platform where AI agents pick up a ticket, write the change, run the tests and open a pull request. A human reviews that pull request and decides whether it is merged. You run Opificia on servers you choose, with models you choose, including open-weight models (models whose trained weights are published and can be run anywhere). Nothing in the design requires a service that we, or anyone else, host for you.
This repository holds the project's foundations, such as licences, policies and the way we make decisions, and a first prototype. The prototype runs the whole loop on one machine: from a labelled GitHub issue to a plan that a person approves, to a pull request that a person reviews. docs/prototype.md explains how to run it.
Why it exists
Organisations in Europe want to automate software work. Many of them also need to audit that automation, host it themselves and keep it under European law. Many agentic coding tools are hosted services that depend on clouds and models controlled from outside Europe. Opificia is an attempt to build the same kind of tool as open source, designed from the start to run where you decide.
SOVEREIGNTY.md explains what we mean by sovereignty, and the design commitments the code will be held to.
Principles
- **Self-hostable and air-gap capable.** No feature requires a vendor-hosted service.
- **Model-agnostic, open-weight models first.** Any model behind an open, documented interface.
- **No required phone-home.** Telemetry is off by default and goes only where you send it.
- **Open standards.** Open protocols and formats over proprietary ones.
- **Humans stay in control.** By default, nothing is merged without a person approving it.
Status and roadmap
We are moving from phase 0, foundations, to phase 1, a first working loop. A prototype of that loop runs today, with Claude Code as its first harness. ROADMAP.md lists the phases ahead. There are no dates yet.
Getting involved
There is early code and plenty of other work to do:
- Join the conversation in GitHub Discussions.
- Read CONTRIBUTING.md before you open a pull request. Every commit needs a Signed-off-by line.
- Propose larger changes as an RFC (a written proposal). See docs/rfcs/.
- Try the prototype with docs/prototype.md and tell us what breaks.
- Issues labelled good first issue are a good place to start.
Every factory needs a twelfth tooth.
Licensing
The core of Opificia is licensed under the GNU Affero General Public License v3.0 only (AGPL-3.0-only). The sdk/, plugins/ and examples/ folders are licensed under Apache-2.0, and the documentation in docs/ under CC-BY-4.0. In plain words: you may use, study, change and share Opificia freely. If you modify the core and let other people use your modified version over a network, for example as a hosted service, you must offer them the source code of your changes under the same licence. Using Opificia unmodified, or building plugins against the SDK, carries no such obligation. REUSE.toml maps every file to its licence, and ADR 0002 explains why we chose this model.