Quickstart
Tres comandos. Sin registro.
Open Design tiene un único punto de entrada: pnpm tools-dev. El daemon crea sola una carpeta oculta .od/ para la BD SQLite de proyectos y los artifacts por proyecto. No hay paso od init.
Requisitos
- · Node ~24 —
nvm install 24 && nvm use 24ofnm install 24 && fnm use 24 - · pnpm 10.33.x —
corepack enable && corepack pnpm --version - · Al menos un coding-agent CLI soportado en tu
PATH— Claude Code, Codex, Cursor, Gemini, OpenCode, Qwen, Copilot, Devin, Hermes, Kimi, Kiro, Vibe o Pi (o ninguno, si vas a usar el proxy BYOK)
Tres comandos
git clone https://github.com/nexu-io/open-design.git
cd open-design
corepack enable
pnpm install
pnpm tools-dev run webAbre la URL web que imprime tools-dev. Saca el diálogo de bienvenida, pega una clave de Anthropic (solo necesaria para el fallback BYOK), escribe un prompt, dale a Enviar.
Estado en el primer arranque
El daemon es dueño de una sola carpeta oculta.
.od/
├── app.sqlite ← proyectos · conversaciones · mensajes · tabs abiertas
├── artifacts/ ← renders puntuales «Save to disk» (con timestamp)
└── projects/<id>/ ← directorio de trabajo por proyecto, también el cwd del agente| Quiero… | Haz esto |
|---|---|
| Echar un vistazo a lo que hay | ls -la .od && sqlite3 .od/app.sqlite '.tables' |
| Volver al estado inicial | pnpm tools-dev stop && rm -rf .od && pnpm tools-dev run web |
| Moverlo a otro sitio | Aún no soportado — la ruta está hardcodeada relativa al repo |
Comandos del ciclo de vida
Todo bajo pnpm tools-dev.
pnpm tools-dev start # arranca daemon + web (en segundo plano)
pnpm tools-dev run web # equivalente en primer plano
pnpm tools-dev stop # parar todo
pnpm tools-dev status # qué corre, dónde
pnpm tools-dev logs # tail de logs daemon + web
pnpm tools-dev inspect # IPC contra procesos vivos
pnpm tools-dev check # health checksPara arranque desktop / en segundo plano, reinicios en puertos fijos y detalles del despachador de generación de medios (OD_BIN, OD_DAEMON_URL), mira el QUICKSTART.md en GitHub.
Plataformas · v0.5.0
Tres plataformas, tres estados.
v0.5.0 dice claro en qué punto está cada plataforma. Elige la fila que corresponda a tu máquina.
| Plataforma | Estado | Notas |
|---|---|---|
| macOS | Estable | Apple Silicon (arm64) solo — sin build de Intel. macOS 11 Big Sur o más reciente. |
| Windows | Estable · sin firmar | x64, Windows 10 / 11. SmartScreen avisa en el primer arranque — elige More info → Run anyway. |
| Linux | Solo headless | Ciclo de vida CLI (install / start / stop) con soporte de primera desde v0.5.0. Aún sin paquete GUI — encaja en servidores y CI. Ver abajo. |
Linux · headless
Hacer correr Open Design en un servidor sin DISPLAY.
v0.5.0 trae un camino de ciclo de vida sin gráficos. Levanta daemon y web en una caja Linux headless y luego pégale desde el navegador del portátil. Mismo backend, sin la cáscara de Electron por delante.
pnpm install
pnpm tools-pack linux install --headless # configuración inicial
pnpm tools-pack linux start --headless # daemon + web, sin Electron
pnpm tools-pack linux stop --headless
pnpm tools-pack linux logs # seguir el log headlessPaquetes Apt, permisos de namespace y el caveat de FUSE están todos en tools/pack/README.md. Verificado en Ubuntu 24.04 y Arch Linux. Llegó en 0.5.0 vía PR #686.
Auto-alojamiento · v0.5.0
O bien como un único contenedor.
v0.5.0 entrega un camino oficial de Docker Compose. Una imagen Alpine (docker.io/vanjayak/open-design). El daemon sirve a la vez la API y el export estático de Next.js ya construido — sin nginx aparte, sin contenedor de frontend aparte.
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:7456Por defecto: bind a 127.0.0.1:7456, tope de memoria 384 MB, volumen de runtime montado en /app/.od. No expongas el daemon directamente a la interfaz pública — la API no tiene autenticación para clientes que no sean navegador. Pon delante un reverse proxy autenticado, túnel SSH o VPN. Documentación completa: deploy/README.md. La imagen no empaqueta a propósito los CLI de Claude / Codex / Gemini — esos quedan fuera del contenedor.
¿Y ahora qué?
Elige algo que renderizar.
Una vez que el daemon está arriba, te hace falta un skill (qué hacer), un design system (cómo debe verse) y, idealmente, una referencia de cómo es «bien hecho».