Quickstart
Trzy komendy. Bez rejestracji.
Open Design ma jeden punkt wejścia: pnpm tools-dev. Daemon sam tworzy ukryty folder .od/ na bazę projektów SQLite i artefakty per projekt. Nie ma kroku od init.
Wymagania
- · Node ~24 —
nvm install 24 && nvm use 24lubfnm install 24 && fnm use 24 - · pnpm 10.33.x —
corepack enable && corepack pnpm --version - · Co najmniej jedno wspierane coding-agent CLI w
PATH— Claude Code, Codex, Cursor, Gemini, OpenCode, Qwen, Copilot, Devin, Hermes, Kimi, Kiro, Vibe albo Pi (lub żadne, jeśli będziesz używać proxy BYOK)
Trzy komendy
git clone https://github.com/nexu-io/open-design.git
cd open-design
corepack enable
pnpm install
pnpm tools-dev run webOtwórz URL web wypisany przez tools-dev. Wywołaj dialog powitalny, wklej klucz Anthropic (potrzebny tylko do fallbacku BYOK), wpisz prompt, wciśnij Send.
Stan przy pierwszym starcie
Daemon jest właścicielem jednego ukrytego folderu.
.od/
├── app.sqlite ← projekty · konwersacje · wiadomości · otwarte zakładki
├── artifacts/ ← jednorazowe rendery «Save to disk» (z timestampem)
└── projects/<id>/ ← katalog roboczy per projekt, też cwd agenta| Chcę… | Zrób tak |
|---|---|
| Zerknąć, co tam jest | ls -la .od && sqlite3 .od/app.sqlite '.tables' |
| Wrócić do czystego stanu | pnpm tools-dev stop && rm -rf .od && pnpm tools-dev run web |
| Przenieść gdzie indziej | Jeszcze nie wspierane — ścieżka jest hardkodowana relatywnie do repo |
Komendy cyklu życia
Wszystko pod pnpm tools-dev.
pnpm tools-dev start # odpal daemon + web (w tle)
pnpm tools-dev run web # ekwiwalent na pierwszym planie
pnpm tools-dev stop # zatrzymaj wszystko
pnpm tools-dev status # co jedzie, gdzie
pnpm tools-dev logs # tail logów daemon + web
pnpm tools-dev inspect # IPC do żywych procesów
pnpm tools-dev check # health checkiO start desktop / w tle, restarty na stałych portach i szczegóły dispatchera generowania mediów (OD_BIN, OD_DAEMON_URL) — w QUICKSTART.md na GitHubie.
Platformy · v0.5.0
Trzy platformy, trzy stany.
0.5.0 nie ściemnia, gdzie każda platforma realnie stoi. Wybierz wiersz, który pasuje do twojej maszyny.
| Platforma | Status | Notatki |
|---|---|---|
| macOS | Stabilne | Tylko Apple Silicon (arm64) — brak buildu Intela. macOS 11 Big Sur lub nowszy. |
| Windows | Stabilne · niepodpisane | x64, Windows 10 / 11. SmartScreen ostrzega przy pierwszym uruchomieniu — wybierz Więcej informacji → Uruchom mimo to. |
| Linux | Tylko headless | Pierwszorzędny cykl życia CLI (install / start / stop) wjechał w 0.5.0. Brak paczki GUI — pasuje do serwerów i CI. Patrz niżej. |
Linux · headless
Postaw Open Design na serwerze bez DISPLAY.
v0.5.0 dowozi nie-graficzną ścieżkę cyklu życia. Postaw daemon i web na headlessowym Linuksie, potem wal po nim z przeglądarki na laptopie. Ten sam backend, bez Electron-shella z przodu.
pnpm install
pnpm tools-pack linux install --headless # jednorazowy setup
pnpm tools-pack linux start --headless # daemon + web, bez Electrona
pnpm tools-pack linux stop --headless
pnpm tools-pack linux logs # tail loga headlessPaczki apt, uprawnienia namespace'ów i temat FUSE — udokumentowane w tools/pack/README.md. Zweryfikowane na Ubuntu 24.04 i Arch Linuksie. Wjechało w 0.5.0 przez PR #686.
Self-hosting · v0.5.0
Albo postaw to jako pojedynczy kontener.
v0.5.0 dowozi oficjalną ścieżkę Docker Compose. Jeden Alpine'owy obraz (docker.io/vanjayak/open-design). Daemon serwuje i API, i wybudowany statyczny export Next.js — bez osobnego nginxa, bez osobnego kontenera frontendu.
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:7456Domyślnie: bind na 127.0.0.1:7456, limit 384 MB pamięci, runtime volume w /app/.od. Nie wystawiaj daemona na publiczny interfejs 'as-is' — API jest niezautentykowane dla klientów spoza przeglądarki. Postaw przed nim authenticated reverse proxy, tunel SSH albo VPN. Pełna dokumentacja: deploy/README.md. Obraz nie pakuje CLI Claude / Codex / Gemini — celowo, trzymaj je poza kontenerem.
I co teraz?
Wybierz coś do wyrenderowania.
Gdy daemon stoi, potrzebujesz skilla (co zrobić), design systemu (jak ma wyglądać) i najlepiej referencji, jak wygląda «dobrze».