Hızlı başlangıç
Üç komut. Kayıt yok.
Open Design'ın tek bir giriş noktası var: pnpm tools-dev. Daemon, SQLite proje DB'si ve proje bazlı artifact'ler için gizli bir .od/ klasörü otomatik oluşturur. od init adımı yok.
Gereksinimler
- · Node ~24 —
nvm install 24 && nvm use 24veyafnm install 24 && fnm use 24 - · pnpm 10.33.x —
corepack enable && corepack pnpm --version - ·
PATH'inde desteklenen en az bir coding-agent CLI — Claude Code, Codex, Cursor, Gemini, OpenCode, Qwen, Copilot, Devin, Hermes, Kimi, Kiro, Vibe veya Pi (veya BYOK proxy kullanacaksan hiçbiri)
Üç komut
git clone https://github.com/nexu-io/open-design.git
cd open-design
corepack enable
pnpm install
pnpm tools-dev run webtools-dev'in yazdırdığı web URL'sini aç. Hoş geldin diyaloğunu çıkar, bir Anthropic anahtarı yapıştır (yalnızca BYOK fallback yolu için gerekir), bir prompt yaz, Send'e bas.
İlk çalıştırma durumu
Daemon tek bir gizli klasöre sahip.
.od/
├── app.sqlite ← projeler · konuşmalar · mesajlar · açık sekmeler
├── artifacts/ ← tek seferlik «Save to disk» render'ları (zaman damgalı)
└── projects/<id>/ ← proje bazlı çalışma dizini, aynı zamanda agent'ın cwd'si| Şunu yapmak istiyorum… | Bunu yap |
|---|---|
| İçeride ne var bakmak | ls -la .od && sqlite3 .od/app.sqlite '.tables' |
| Temiz bir başlangıca dönmek | pnpm tools-dev stop && rm -rf .od && pnpm tools-dev run web |
| Başka bir yere taşımak | Henüz desteklenmiyor — yol repo'ya göre hard-coded |
Yaşam döngüsü komutları
Hepsi şunun altında: pnpm tools-dev.
pnpm tools-dev start # daemon + web başlat (arka plan)
pnpm tools-dev run web # ön plan eşdeğeri
pnpm tools-dev stop # her şeyi durdur
pnpm tools-dev status # ne çalışıyor, nerede
pnpm tools-dev logs # daemon + web log'larını tail et
pnpm tools-dev inspect # çalışan süreçlere IPC
pnpm tools-dev check # sağlık kontrolleriDesktop / arka plan başlangıcı, sabit port restart'ları ve medya üretim dispatcher detayları (OD_BIN, OD_DAEMON_URL) için GitHub'daki QUICKSTART.md'a bak.
Platformlar · v0.5.0
Üç platform, üç durum.
0.5.0 her platformun nerede durduğu konusunda dürüst. Makinene uyan satırı seç.
| Platform | Durum | Notlar |
|---|---|---|
| macOS | Kararlı | Yalnızca Apple Silicon (arm64) — Intel build yok. macOS 11 Big Sur veya daha yeni. |
| Windows | Kararlı · imzasız | x64, Windows 10 / 11. SmartScreen ilk açılışta uyarır — Daha fazla bilgi → Yine de çalıştır'ı seç. |
| Linux | Yalnızca headless | Birinci sınıf CLI yaşam döngüsü (install / start / stop) 0.5.0'da indi. Henüz GUI paketi yok — sunucu ve CI'a uyar. Aşağıya bak. |
Linux · arayüzsüz
DISPLAY'siz bir sunucuda Open Design çalıştır.
v0.5.0 grafik olmayan bir yaşam döngüsü yolu çıkardı. Daemon ve web'i headless bir Linux kutusunda ayağa kaldır, sonra laptop tarayıcından vur. Aynı backend, önünde Electron shell yok.
pnpm install
pnpm tools-pack linux install --headless # tek seferlik kurulum
pnpm tools-pack linux start --headless # daemon + web, Electron'suz
pnpm tools-pack linux stop --headless
pnpm tools-pack linux logs # headless log'u tail etApt paketleri, namespace izinleri ve FUSE uyarısı tools/pack/README.md'de belgelenmiş. Ubuntu 24.04 ve Arch Linux'ta doğrulandı. PR #686 üzerinden 0.5.0'da indi.
Kendi sunucunda · v0.5.0
Veya tek bir container olarak çalıştır.
v0.5.0 resmi bir Docker Compose yolu çıkardı. Tek bir Alpine image'i (docker.io/vanjayak/open-design). Daemon hem API'yi hem de build edilmiş Next.js statik export'u sunar — ayrı nginx yok, ayrı frontend container yok.
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:7456Varsayılanlar: 127.0.0.1:7456'ya bağlı, 384 MB bellek tavanı, runtime volume /app/.od'de. Daemon'u olduğu gibi kamuya açık bir arayüzde yayınlama — tarayıcı dışı istemciler için API doğrulanmamış. Önüne kimlik doğrulamalı bir reverse proxy, SSH tunnel veya VPN koy. Tam dokümanlar: deploy/README.md. Image bilinçli olarak Claude / Codex / Gemini CLI'larını paketlemiyor — onları container dışında tut.
Şimdi ne?
Render etmek için bir şey seç.
Daemon ayağa kalkınca bir skill (ne yapacağı), bir design system (nasıl görüneceği) ve ideal olarak iyi neye benzer için bir referans gerekir.