
software-factory
Software Factory mit Claude Code auf deinem eigenen Server
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up software-factory (git-clone project) into my current project. Found on https://claudeers.com/software-factory Repo: https://github.com/AlexPEClub/software-factory Homepage/docs: — Detected install method: git-clone → git clone https://github.com/AlexPEClub/software-factory Category: security. Platforms: cli, api, web. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: unknown; community-verified: false. Confirm the source before running anything.
git clone https://github.com/AlexPEClub/software-factory
// compatibility
| Platforms | cli, api, web |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | TypeScript |
Software Factory
Eine Software Factory mit Claude Code, die rund um die Uhr auf deinem eigenen Server läuft.
🖥️ Server: Die Factory läuft auf einem Linux-VPS. Getestet ist sie auf dem Hostinger KVM 2 (2 CPU-Kerne, 8 GB RAM) mit der Vorlage „Ubuntu 24.04 mit Claude Code“. Server holen: hostinger.com/alexclaude. Mit dem Code
ALEXCLAUDEsparst du zusätzlich 10 %. Einrichtung Schritt für Schritt: docs/hostinger-vps-setup.mdAffiliate-Link: Wenn du darüber kaufst, bekomme ich eine Provision. Für dich ändert sich am Preis nichts, mit dem Code wird es günstiger.
Du entscheidest, was gebaut wird. Die Factory baut es.
- Du schreibst lokal mit Claude Code die Spec (
/write-spec), prüfst sie und pushst sie. - Du übergibst sie mit
/to-factoryan die Factory. Das legt ein GitHub Issue mit Labelfactoryan, das auf die Spec zeigt. - Ein Agent auf deinem Server prüft die Spec und schreibt Testszenarien. Ein zweiter Agent entwickelt: Architektur, Umsetzung, Tests, Pull Request mit Belegen (Checks, Screenshots, getroffene Annahmen). Ein dritter, unabhängiger Agent nimmt das Ergebnis mit den Testszenarien ab, die der Entwickler nie gesehen hat. Ist etwas unklar, fragt die Factory im Issue nach und macht weiter, sobald du antwortest.
- Du prüfst den Pull Request und mergst. Gemergt wird immer von dir.
Bugs gehen auch ohne Spec: Issue mit Label factory anlegen und beschreiben, was falsch ist und was du erwartest.
Status auf dem Board: Neu → In Prüfung → Rückfrage / Abgelehnt → Freigegeben → In Arbeit (Architektur · Umsetzung · Tests) → Abnahme → Review → Fertig, bei technischen Fehlern Fehlgeschlagen. Prüfung, Entwicklung und Abnahme sind getrennte Läufe in eigenen Containern: Neue Issues werden sofort geprüft, entwickelt wird, sobald ein Platz frei ist.
🚧 Erste Version, in aktiver Entwicklung.
So funktioniert es
GitHub Issue (Label "factory")
│
▼
Runner auf deinem Server ── prüft jede Minute die Issues
│
▼
Eigener Docker-Container pro Issue
└─ Claude Code + Playbook + Workflow-Skills
Triage → Analyse → Umsetzung → Prüfung → Pull Request
│
├─ unklar? → Frage als Kommentar im Issue, wartet auf dich
└─ fertig? → Pull Request mit Checks + Screenshots
│
▼
Du reviewst und mergst
- Runner (
runner/): kleiner Dienst auf dem Server. Holt Issues, startet Container, setzt Labels und Board-Status. Schreibt selbst keinen Code. - Job-Image (
image/): Claude Code, GitHub CLI, git, Node und Chromium (für Tests und Screenshots). - Playbook (
playbooks/factory.md): die festen Regeln für jeden Lauf. Stages melden, bei Unklarheit fragen statt raten, Pflicht-Checks, nie selbst mergen. - Workflow (
workflows/starter-kit/): wie entwickelt wird. Standard ist der Workflow aus dem AI Coding Starter Kit:architecture → build → qaauf Basis deiner Spec, mit getrennten Dateien pro Feature (spec.md,design.md,qa-report.md). Austauschbar, siehe workflow.md. - Stack-Packs (
workflows/starter-kit/stacks/): Regeln für einen bestimmten Stack (z. B.nextjs,supabase). Welche gelten, steht indocs/stack.mddes Projekts. Die Factory ist stack-unabhängig. - Lokale Skills (
local-skills/):init(Projekt aufsetzen inkl. Stack),write-spec(Spec im Interview erarbeiten),to-factory(an die Factory übergeben). Einmal pro Rechner installieren:./scripts/install-local-skills.sh. - Projekt-Vorlage: factory-template, stack-unabhängig. Neues Projekt:
./scripts/new-project.sh mein-projekt.
Voraussetzungen
- Ein Linux-Server mit Ubuntu 24.04, mindestens 2 vCPU und 8 GB RAM
- Ein Claude-Abo (Pro, Max, Team oder Enterprise) oder ein Anthropic-API-Key
- Ein GitHub-Account
Schnellstart
git clone https://github.com/AlexPEClub/software-factory.git /opt/software-factory
cd /opt/software-factory
./setup.sh
Danach:
- Claude-Login: auf deinem Rechner
claude setup-tokenausführen und den Token alsCLAUDE_CODE_OAUTH_TOKEN=...in/etc/software-factory/secrets.enveintragen - GitHub-Login auf dem Server:
gh auth login -s project - Factory starten:
systemctl restart software-factory - Auf deinem Rechner:
./scripts/install-local-skills.sh, dannFACTORY_SERVER=root@DEINE-IP ./scripts/new-project.sh mein-projekt. Legt das Repo aus der Vorlage an und bindet es samt Labels und Kanban-Board an die Factory an. Ein bestehendes Repo bindest du stattdessen auf dem Server mit./scripts/add-repo.sh dein-name/dein-repoan. - Im Projekt: Briefing in
docs/briefing.md→/init→ pro Feature/write-spec→/to-factory
Die ausführliche Schritt-für-Schritt-Anleitung (inkl. Server bei Hostinger): docs/hostinger-vps-setup.md.
Messen und verbessern
Jeder Lauf wird mit Dauer, Schritten und Ergebnis in /var/lib/software-factory/metrics.jsonl festgehalten. Auswertung auf dem Server:
factory-stats # alles
factory-stats --tage 7 # letzte Woche
Weil jede Aufgabe denselben Ablauf durchläuft, siehst du so, ob eine Änderung am Playbook, an den Skills oder am Modell etwas bringt: Laufzeit pro Aufgabe, Anteil Rückfragen, wie oft die Abnahme beim ersten Mal besteht.
Das Ziel-Repo
Die Factory liest .factory/setup.json im Ziel-Repo:
{
"install": "npm ci",
"dev": "npm run dev -- -p $PORT",
"checks": {
"lint": "npm run lint",
"typecheck": "npx tsc --noEmit",
"test": "npm test",
"build": "npm run build"
}
}
/init legt sie passend zum Stack an. Braucht dein Stack eine andere Laufzeit als Node oder Python, ergänzt /init eine .factory/Dockerfile, die auf dem Factory-Image aufbaut.
Claude-Abo: was ist erlaubt?
Die Factory startet die unveränderte, offizielle Claude Code CLI auf deinem eigenen Server. Angemeldet wird mit deinem eigenen Abo über claude setup-token, den Weg, den Anthropic für Skripte und CI dokumentiert (Authentication). Das Repo speichert oder teilt keine fremden Logins.
- Abo-Limits gelten für die Factory und deine normale Claude-Nutzung zusammen. Starte mit
maxParallel: 1–2. - Für Teams oder wenn du die Factory als Dienst für andere betreibst:
ANTHROPIC_API_KEYverwenden (Legal and Compliance). - Stand: November 2026. Anthropic kann die Regeln ändern, prüf die verlinkte Doku.
Sicherheit und Grenzen (Version 0.1)
- Jeder Lauf hat einen eigenen Container mit Speicher- und Prozesslimit. Standard: zwei Agent-Läufe gleichzeitig (
maxParallel: 2), passend zu 8 GB RAM. - Antworten und Änderungswünsche nimmt die Factory nur von dir an (plus
allowedUsers). Fremde Kommentare sieht der Agent nicht. - Ein Bau zählt nur, wenn
factory-verifyauf genau dem gepushten Commit grün ist und die Spec unverändert bleibt. Besteht die Abnahme nach zwei Runden nicht, landet der PR mit „Abnahme nicht bestanden“ bei dir, nie als bestanden. - Vorschauen laufen ohne Zugangsdaten, mit Passwort und mit Domain über HTTPS.
- Die Agents arbeiten mit deinem GitHub-Login. Für mehr Trennung: eigener GitHub-Account für die Factory oder ein Fine-grained Token, der nur deine Factory-Repos erreicht.
- Getestet: Ubuntu 24.04 auf Hostinger KVM 2, Next.js-Projekte. Weitere Stacks sind vorgesehen, aber noch nicht erprobt.
Tests für den Runner: node --test runner/main.test.ts (Node 22.6+, ohne GitHub und Docker).
Lizenz
MIT
// faq
What is software-factory?
Software Factory mit Claude Code auf deinem eigenen Server. It is open-source on GitHub.
Is software-factory free to use?
software-factory is open-source under the MIT license, so it is free to use.
What category does software-factory belong to?
software-factory is listed under security in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/software-factory)
// retro hit counter
[](https://claudeers.com/software-factory)
// reviews
// guestbook
// related in Security & Compliance
A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specia…
π RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.
Prowler is the world’s most widely used open-source cloud security platform that automates security and compliance across any cloud environment.
🐶 A curated list of Web Security materials and resources.