Quickstart
Trois commandes. Sans inscription.
Open Design a un point d'entrée unique : pnpm tools-dev. Le daemon crée automatiquement un dossier caché .od/ pour la base SQLite des projets et les artifacts par projet. Pas d'étape od init.
Prérequis
- · Node ~24 —
nvm install 24 && nvm use 24oufnm install 24 && fnm use 24 - · pnpm 10.33.x —
corepack enable && corepack pnpm --version - · Au moins un CLI d'agent de coding supporté dans votre
PATH— Claude Code, Codex, Cursor, Gemini, OpenCode, Qwen, Copilot, Devin, Hermes, Kimi, Kiro, Vibe ou Pi (ou aucun, si vous utilisez le proxy BYOK)
Trois commandes
git clone https://github.com/nexu-io/open-design.git
cd open-design
corepack enable
pnpm install
pnpm tools-dev run webOuvrez l'URL web qu'imprime tools-dev. Faites apparaître la boîte de bienvenue, collez une clé Anthropic (uniquement nécessaire pour le fallback BYOK), tapez un prompt, faites Envoyer.
État au premier démarrage
Le daemon possède un seul dossier caché.
.od/
├── app.sqlite ← projets · conversations · messages · tabs ouverts
├── artifacts/ ← rendus « Sauvegarder sur disque » ponctuels (horodatés)
└── projects/<id>/ ← répertoire de travail par projet, aussi le cwd de l'agent| Vous voulez… | Faites ça |
|---|---|
| Voir ce qu'il y a dedans | ls -la .od && sqlite3 .od/app.sqlite '.tables' |
| Repartir d'une page blanche | pnpm tools-dev stop && rm -rf .od && pnpm tools-dev run web |
| Le déplacer ailleurs | Pas encore supporté — le chemin est codé en dur, relatif au repo |
Commandes de cycle de vie
Tout sous pnpm tools-dev.
pnpm tools-dev start # lance daemon + web (en arrière-plan)
pnpm tools-dev run web # équivalent en avant-plan
pnpm tools-dev stop # tout arrêter
pnpm tools-dev status # ce qui tourne, où
pnpm tools-dev logs # tail des logs daemon + web
pnpm tools-dev inspect # IPC dans les processus en cours
pnpm tools-dev check # health checksPour le démarrage desktop / en arrière-plan, les redémarrages sur ports fixes et les détails du dispatcher de génération de médias (OD_BIN, OD_DAEMON_URL), voir QUICKSTART.md sur GitHub.
Plateformes · v0.5.0
Trois plateformes, trois états.
v0.5.0 dit franchement où en est chaque plateforme. Choisissez la ligne qui correspond à votre machine.
| Plateforme | État | Notes |
|---|---|---|
| macOS | Stable | Apple Silicon (arm64) uniquement — pas de build Intel. macOS 11 Big Sur ou plus récent. |
| Windows | Stable · non signé | x64, Windows 10 / 11. SmartScreen prévient au premier lancement — choisissez More info → Run anyway. |
| Linux | Headless seulement | Cycle de vie CLI (install / start / stop) en support de premier plan depuis v0.5.0. Pas de paquet GUI pour l'instant — convient aux serveurs et à la CI. Voir ci-dessous. |
Linux · headless
Faire tourner Open Design sur un serveur sans DISPLAY.
v0.5.0 livre un cycle de vie non graphique. Lancez le daemon et le web sur une machine Linux headless, puis tapez dessus depuis le navigateur de votre laptop. Même backend, juste sans la coque Electron devant.
pnpm install
pnpm tools-pack linux install --headless # mise en place initiale
pnpm tools-pack linux start --headless # daemon + web, sans Electron
pnpm tools-pack linux stop --headless
pnpm tools-pack linux logs # suivre les logs headlessPaquets Apt, permissions namespace et le caveat FUSE sont tous documentés dans tools/pack/README.md. Validé sur Ubuntu 24.04 et Arch Linux. Arrivé en 0.5.0 via PR #686.
Auto-hébergement · v0.5.0
Ou bien comme un seul conteneur.
v0.5.0 fournit un chemin Docker Compose officiel. Une image Alpine (docker.io/vanjayak/open-design). Le daemon sert à la fois l'API et l'export statique Next.js déjà bâti — pas de nginx séparé, pas de conteneur frontend séparé.
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:7456Par défaut : binding sur 127.0.0.1:7456, plafond mémoire 384 Mo, volume runtime monté sur /app/.od. N'exposez pas le daemon directement sur l'interface publique — l'API n'a pas d'authentification pour les clients non navigateur. Mettez devant un reverse proxy authentifié, un tunnel SSH ou un VPN. Doc complète : deploy/README.md. L'image n'embarque volontairement pas les CLI Claude / Codex / Gemini — ils restent en dehors du conteneur.
Et maintenant ?
Choisissez quelque chose à rendre.
Une fois le daemon en place, il vous faut un skill (quoi faire), un design system (à quoi ça doit ressembler), et idéalement une référence de ce à quoi ressemble « bien ».