Quickstart
Tre comandi. Senza registrazione.
Open Design ha un solo punto d'ingresso: pnpm tools-dev. Il daemon crea da solo una cartella nascosta .od/ per il DB SQLite dei progetti e gli artifact per progetto. Non c'è uno step od init.
Requisiti
- · Node ~24 —
nvm install 24 && nvm use 24ofnm install 24 && fnm use 24 - · pnpm 10.33.x —
corepack enable && corepack pnpm --version - · Almeno un coding-agent CLI supportato nel tuo
PATH— Claude Code, Codex, Cursor, Gemini, OpenCode, Qwen, Copilot, Devin, Hermes, Kimi, Kiro, Vibe o Pi (oppure nessuno, se userai il proxy BYOK)
Tre comandi
git clone https://github.com/nexu-io/open-design.git
cd open-design
corepack enable
pnpm install
pnpm tools-dev run webApri l'URL web stampato da tools-dev. Fai apparire il dialog di benvenuto, incolla una chiave Anthropic (serve solo per il fallback BYOK), scrivi un prompt, premi Invia.
Stato al primo avvio
Il daemon possiede una sola cartella nascosta.
.od/
├── app.sqlite ← progetti · conversazioni · messaggi · tab aperte
├── artifacts/ ← render una tantum «Save to disk» (con timestamp)
└── projects/<id>/ ← directory di lavoro per progetto, anche cwd dell'agente| Voglio… | Fai così |
|---|---|
| Dare un'occhiata a cosa c'è dentro | ls -la .od && sqlite3 .od/app.sqlite '.tables' |
| Tornare alla pagina bianca | pnpm tools-dev stop && rm -rf .od && pnpm tools-dev run web |
| Spostarlo altrove | Ancora non supportato — il path è hardcoded relativo al repo |
Comandi del ciclo di vita
Tutto sotto pnpm tools-dev.
pnpm tools-dev start # avvia daemon + web (in background)
pnpm tools-dev run web # equivalente in foreground
pnpm tools-dev stop # ferma tutto
pnpm tools-dev status # cosa gira, dove
pnpm tools-dev logs # tail dei log daemon + web
pnpm tools-dev inspect # IPC nei processi vivi
pnpm tools-dev check # health checkPer avvio desktop / in background, restart su porte fisse e dettagli del dispatcher di generazione media (OD_BIN, OD_DAEMON_URL), vedi QUICKSTART.md su GitHub.
Piattaforme · v0.5.0
Tre piattaforme, tre stati.
v0.5.0 dice schietto a che punto è ogni piattaforma. Scegli la riga che corrisponde alla tua macchina.
| Piattaforma | Stato | Note |
|---|---|---|
| macOS | Stabile | Solo Apple Silicon (arm64) — niente build Intel. macOS 11 Big Sur o superiore. |
| Windows | Stabile · non firmato | x64, Windows 10 / 11. SmartScreen avvisa al primo avvio — scegli More info → Run anyway. |
| Linux | Solo headless | Ciclo di vita CLI (install / start / stop) con supporto di prima fascia da v0.5.0. Pacchetto GUI ancora no — adatto a server e CI. Vedi sotto. |
Linux · headless
Far girare Open Design su un server senza DISPLAY.
v0.5.0 consegna un percorso di ciclo di vita non grafico. Tira su daemon e web su una macchina Linux headless e bussa dal browser del tuo portatile. Stesso backend, solo senza la scocca Electron davanti.
pnpm install
pnpm tools-pack linux install --headless # configurazione iniziale
pnpm tools-pack linux start --headless # daemon + web, senza Electron
pnpm tools-pack linux stop --headless
pnpm tools-pack linux logs # tail del log headlessPacchetti Apt, permessi namespace e il caveat FUSE sono tutti in tools/pack/README.md. Verificato su Ubuntu 24.04 e Arch Linux. Arrivato in 0.5.0 via PR #686.
Auto-ospitato · v0.5.0
Oppure come un singolo container.
v0.5.0 consegna un percorso ufficiale di Docker Compose. Un'immagine Alpine (docker.io/vanjayak/open-design). Il daemon serve sia l'API che l'export statico Next.js già buildato — nessun nginx separato, nessun container frontend separato.
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:7456Default: bind su 127.0.0.1:7456, tetto di memoria 384 MB, volume runtime montato su /app/.od. Non esporre il daemon direttamente sull'interfaccia pubblica — l'API non ha auth per client non browser. Metti davanti un reverse proxy autenticato, tunnel SSH o VPN. Documentazione completa: deploy/README.md. L'immagine non bundla apposta i CLI di Claude / Codex / Gemini — quelli stanno fuori dal container.
E adesso?
Scegli qualcosa da renderizzare.
Quando il daemon è su, ti serve uno skill (cosa fare), un design system (come deve apparire) e idealmente un riferimento di com'è «buono».