Швидкий старт
Три команди. Без реєстрації.
В Open Design одна точка входу: pnpm tools-dev. Daemon сам створює прихований .od/ для SQLite-бази проєкту і артефактів кожного проєкту. Кроку od init не існує.
Вимоги
- · Node ~24 —
nvm install 24 && nvm use 24абоfnm install 24 && fnm use 24 - · pnpm 10.33.x —
corepack enable && corepack pnpm --version - · У
PATHхоч один підтриманий CLI coding-agent-а — Claude Code, Codex, Cursor, Gemini, OpenCode, Qwen, Copilot, Devin, Hermes, Kimi, Kiro, Vibe або Pi (або жодного, якщо плануєш BYOK proxy)
Три команди
git clone https://github.com/nexu-io/open-design.git
cd open-design
corepack enable
pnpm install
pnpm tools-dev run webВідкрий web-URL, який надрукував tools-dev. Виклич вікно вітання, встав ключ Anthropic (потрібен лише для BYOK-fallback-у), напиши prompt, тицьни Send.
Стан після першого запуску
У daemon-а одна прихована папка.
.od/
├── app.sqlite ← projects · conversations · messages · open tabs
├── artifacts/ ← разові render-и «Save to disk» (з timestamp-ом)
└── projects/<id>/ ← робоча директорія кожного проєкту, вона ж cwd для agent-а| Хочу… | Зроби так |
|---|---|
| Подивитися, що там | ls -la .od && sqlite3 .od/app.sqlite '.tables' |
| Скинути до чистого стану | pnpm tools-dev stop && rm -rf .od && pnpm tools-dev run web |
| Перенести в інше місце | Поки не підтримано — шлях захардкоджений відносно репо |
Команди життєвого циклу
Усе під pnpm tools-dev.
pnpm tools-dev start # завести daemon + web (у фоні)
pnpm tools-dev run web # еквівалент на передньому плані
pnpm tools-dev stop # зупинити все
pnpm tools-dev status # що працює, де
pnpm tools-dev logs # tail логів daemon + web
pnpm tools-dev inspect # IPC у живі процеси
pnpm tools-dev check # health-перевіркиПро desktop / фоновий старт, рестарти на фіксованих портах і деталі диспатчера генерації медіа (OD_BIN, OD_DAEMON_URL) — у QUICKSTART.md на GitHub.
Платформи · v0.5.0
Три платформи, три стани.
0.5.0 чесно каже, де зараз стоїть кожна платформа. Обери рядок, який збігається з твоєю машиною.
| Платформа | Стан | Нотатки |
|---|---|---|
| macOS | Стабільно | Лише Apple Silicon (arm64) — Intel-збірки немає. macOS 11 Big Sur або новіше. |
| Windows | Стабільно · без підпису | x64, Windows 10 / 11. SmartScreen попереджає при першому запуску — обери Більше → Запустити все одно. |
| Linux | Лише headless | Першокласний CLI-цикл (install / start / stop) приземлився в 0.5.0. GUI-пакета ще немає — підходить для серверів і CI. Дивись нижче. |
Linux · без графіки
Заведи Open Design на сервері без DISPLAY.
v0.5.0 везе неграфічний шлях життєвого циклу. Підніми daemon і web на headless-Linux-боксі, потім лупи по ньому з браузера на ноуті. Той самий backend, без Electron-shell-у спереду.
pnpm install
pnpm tools-pack linux install --headless # одноразовий setup
pnpm tools-pack linux start --headless # daemon + web, без Electron
pnpm tools-pack linux stop --headless
pnpm tools-pack linux logs # tail headless-логуApt-пакети, права на namespace і застереження щодо FUSE — у tools/pack/README.md. Перевірено на Ubuntu 24.04 і Arch Linux. Приземлилося в 0.5.0 через PR #686.
Власний хостинг · v0.5.0
Або запусти його як один контейнер.
v0.5.0 везе офіційний шлях через Docker Compose. Один Alpine-image (docker.io/vanjayak/open-design). Daemon віддає і API, і зібраний Next.js static export — без окремого nginx-а, без окремого frontend-контейнера.
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:7456За замовчуванням: біндиться на 127.0.0.1:7456, ліміт пам'яті 384 МБ, runtime-volume у /app/.od. Не публікуй daemon на публічному інтерфейсі as-is — API не аутентифікований для не-браузерних клієнтів. Постав перед ним аутентифікований reverse proxy, SSH-tunnel або VPN. Повна документація: deploy/README.md. Image зумисне не везе CLI Claude / Codex / Gemini — тримай їх поза контейнером.
І що далі?
Обери, що відрендерити.
Коли daemon піднявся, тобі треба skill (що зробити), design system (як це має виглядати) і в ідеалі — референс, як виглядає «добре».