Quickstart
Три команды. Без регистрации.
У 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 - · Хотя бы один поддерживаемый coding-agent CLI в
PATH— Claude Code, Codex, Cursor, Gemini, OpenCode, Qwen, Copilot, Devin, Hermes, Kimi, Kiro, Vibe или Pi (или ни одного, если работаете через BYOK-прокси)
Три команды
git clone https://github.com/nexu-io/open-design.git
cd open-design
corepack enable
pnpm install
pnpm tools-dev run webОткройте веб-URL, который напечатает tools-dev. Откройте welcome-диалог, вставьте ключ Anthropic (нужен только для BYOK-fallback), введите prompt, нажмите Send.
Состояние при первом запуске
Daemon владеет одной скрытой папкой.
.od/
├── app.sqlite ← проекты · разговоры · сообщения · открытые вкладки
├── artifacts/ ← разовые «Save to disk»-рендеры (с временными метками)
└── projects/<id>/ ← рабочая папка по проекту, она же cwd агента| Хочу… | Сделайте так |
|---|---|
| Заглянуть, что внутри | 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 # эквивалент в foreground
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 / фоновый запуск, перезапуск на фиксированных портах и детали диспетчера media-генерации (OD_BIN, OD_DAEMON_URL) — в QUICKSTART.md на GitHub.
Платформы · v0.5.0
Три платформы, три состояния.
v0.5.0 честно говорит, где сейчас каждая платформа. Выберите строку, что подходит вашей машине.
| Платформа | Статус | Заметки |
|---|---|---|
| macOS | Стабильно | Только Apple Silicon (arm64) — без Intel-сборки. macOS 11 Big Sur и новее. |
| Windows | Стабильно · без подписи | x64, Windows 10 / 11. SmartScreen предупредит при первом запуске — выбирайте More info → Run anyway. |
| Linux | Только headless | CLI lifecycle (install / start / stop) с полноценной поддержкой с v0.5.0. GUI-пакета пока нет — годится для серверов и CI. Подробнее ниже. |
Linux · headless
Запустить Open Design на сервере без DISPLAY.
v0.5.0 поставляет неграфический lifecycle-путь. Поднимите daemon и web на headless-машине Linux, а потом стучитесь к нему из браузера на ноутбуке. Backend тот же, просто без оболочки Electron впереди.
pnpm install
pnpm tools-pack linux install --headless # разовая настройка
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-образ (docker.io/vanjayak/open-design). Daemon отдаёт сразу и API, и собранный статический Next.js-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По умолчанию: bind на 127.0.0.1:7456, потолок памяти 384 MB, runtime-volume монтируется в /app/.od. Не выставляйте daemon напрямую в публичный интерфейс — у API нет аутентификации для не-браузерных клиентов. Поставьте впереди authenticated reverse proxy, SSH-туннель или VPN. Полная документация: deploy/README.md. Образ намеренно не несёт CLI Claude / Codex / Gemini — они остаются вне контейнера.
А дальше?
Выберите, что отрисовать.
Когда daemon поднят, нужны skill (что делать), design system (как должно выглядеть) и в идеале — референс «как должно быть хорошо».