Quickstart
Drei Befehle. Keine Anmeldung.
Open Design hat einen Einstiegspunkt: pnpm tools-dev. Der Daemon legt automatisch einen versteckten .od/-Ordner für die SQLite-Projekt-DB und projektbezogene Artifacts an. Es gibt keinen od init-Schritt.
Voraussetzungen
- · Node ~24 —
nvm install 24 && nvm use 24oderfnm install 24 && fnm use 24 - · pnpm 10.33.x —
corepack enable && corepack pnpm --version - · Mindestens ein unterstütztes Coding-Agent-CLI in Ihrem
PATH— Claude Code, Codex, Cursor, Gemini, OpenCode, Qwen, Copilot, Devin, Hermes, Kimi, Kiro, Vibe oder Pi (oder gar keins, wenn Sie den BYOK-Proxy nutzen)
Drei Befehle
git clone https://github.com/nexu-io/open-design.git
cd open-design
corepack enable
pnpm install
pnpm tools-dev run webÖffnen Sie die Web-URL, die tools-dev ausgibt. Welcome-Dialog aufmachen, einen Anthropic-Schlüssel einfügen (nur für den BYOK-Fallback nötig), Prompt tippen, Senden drücken.
Zustand beim ersten Start
Der Daemon besitzt einen einzigen versteckten Ordner.
.od/
├── app.sqlite ← Projekte · Konversationen · Nachrichten · offene Tabs
├── artifacts/ ← einmalige „Auf Disk speichern"-Renders (zeitgestempelt)
└── projects/<id>/ ← projektbezogenes Arbeitsverzeichnis, auch der cwd des Agents| Sie wollen… | Tun Sie das |
|---|---|
| Reinschauen, was drin ist | ls -la .od && sqlite3 .od/app.sqlite '.tables' |
| Auf Werkszustand zurück | pnpm tools-dev stop && rm -rf .od && pnpm tools-dev run web |
| Den Ordner woandershin | Noch nicht unterstützt — der Pfad ist relativ zum Repo hartkodiert |
Lifecycle-Befehle
Alles unter pnpm tools-dev.
pnpm tools-dev start # Daemon + Web starten (Hintergrund)
pnpm tools-dev run web # äquivalent im Vordergrund
pnpm tools-dev stop # alles stoppen
pnpm tools-dev status # was läuft, wo
pnpm tools-dev logs # Daemon- + Web-Logs tailen
pnpm tools-dev inspect # IPC in laufende Prozesse
pnpm tools-dev check # Health-ChecksFür Desktop- bzw. Hintergrund-Start, Restarts auf festen Ports und Details des Mediengenerierungs-Dispatchers (OD_BIN, OD_DAEMON_URL) siehe QUICKSTART.md auf GitHub.
Plattformen · v0.5.0
Drei Plattformen, drei Zustände.
v0.5.0 sagt offen, wo jede Plattform gerade steht. Wählen Sie die Zeile, die zu Ihrer Maschine passt.
| Plattform | Status | Hinweise |
|---|---|---|
| macOS | Stabil | Apple Silicon (arm64) only — kein Intel-Build. macOS 11 Big Sur oder neuer. |
| Windows | Stabil · unsigniert | x64, Windows 10 / 11. SmartScreen warnt beim ersten Start — wählen Sie More info → Run anyway. |
| Linux | Nur Headless | Erstklassiger CLI-Lifecycle (install / start / stop) ist mit v0.5.0 da. Noch kein GUI-Paket — passt zu Servern und CI. Siehe unten. |
Linux · Headless
Open Design auf einem Server ohne DISPLAY laufen lassen.
v0.5.0 liefert einen nicht-grafischen Lifecycle-Pfad aus. Daemon und Web auf einer Headless-Linux-Box hochfahren, dann vom Laptop-Browser aus ansprechen. Gleicher Backend-Stack, nur ohne Electron-Shell davor.
pnpm install
pnpm tools-pack linux install --headless # einmalige Einrichtung
pnpm tools-pack linux start --headless # Daemon + Web, ohne Electron
pnpm tools-pack linux stop --headless
pnpm tools-pack linux logs # Headless-Log mitlesenApt-Pakete, Namespace-Berechtigungen und FUSE-Hinweis stehen alle in tools/pack/README.md. Auf Ubuntu 24.04 und Arch Linux verifiziert. Mit 0.5.0 PR #686 eingeführt.
Self-Hosting · v0.5.0
Oder als ein einzelner Container.
v0.5.0 liefert einen offiziellen Docker-Compose-Pfad. Ein Alpine-Image (docker.io/vanjayak/open-design). Der Daemon serviert sowohl die API als auch den gebauten Next.js-Static-Export — kein separater nginx, kein separater Frontend-Container.
git clone https://github.com/nexu-io/open-design.git
cd open-design/deploy
OPEN_DESIGN_IMAGE=docker.io/vanjayak/open-design:latest docker compose pull
OPEN_DESIGN_IMAGE=docker.io/vanjayak/open-design:latest docker compose up -d --no-build
# → http://127.0.0.1:7456Defaults: 127.0.0.1:7456 als Bind-Adresse, 384 MB Memory-Cap, Runtime-Volume gemountet auf /app/.od. Den Daemon nicht direkt ans öffentliche Interface hängen — die API hat keine Auth für Nicht-Browser-Clients. Davor einen authentifizierten Reverse-Proxy, SSH-Tunnel oder VPN setzen. Vollständige Doku: deploy/README.md. Das Image bündelt Claude / Codex / Gemini CLIs absichtlich nicht — die bleiben außerhalb des Containers.
Und jetzt?
Suchen Sie sich was zum Rendern aus.
Sobald der Daemon läuft, brauchen Sie einen Skill (was machen), ein Design System (wie es aussehen soll) und idealerweise eine Referenz, wie „gut" aussieht.