Skip to content

API

Jump to bottom
ChiefVenzox edited this page Jun 18, 2026 · 1 revision

API

Backend: FastAPI (backend/app/main.py). Frontend Vite proxy ile relative URL kullanır (/api, /ws) — CORS derdi yok.

POST /api/generate-ui

Tek seferde UI üretir (tam sonuç).

İstek

{
  "instruction": "Create a hero section",
  "input": "Style: dark, orange #c45a26",
  "max_new_tokens": 512,
  "temperature": 0.8,
  "top_k": 40,
  "top_p": 0.95
}

Yanıt

{
  "id": 12,
  "html": "<!DOCTYPE html>...",
  "css": ".hero{...}",
  "notes": "Kısa açıklama",
  "raw": "@@HTML\n...",
  "validation": { "ok": true, "issues": [], "warnings": [] }
}

WS /ws/generate

Token token (streaming) üretim. İstemci yukarıdaki istek JSON'unu yollar; sunucu:

{ "type": "token", "text": "<!DOCTYPE" }      // çok kez
{ "type": "done", "id": 12, "html": "...", "css": "...",
  "notes": "...", "validation": { ... } }
// hata olursa (tek terminal mesaj):
{ "type": "error", "message": "..." }

GET /api/history?limit=20

Son üretimleri döndürür (SQLite).

{ "items": [ { "id": 12, "created_at": 1718, "instruction": "...",
              "input": "...", "html": "...", "css": "...", "notes": "..." } ] }

GET /api/health

{ "ready": true, "device": "cuda", "params_m": 27.5 }

Doğrulama (validation)

backend/app/validation/validate.py — bağımlılıksız, MVP düzeyi:

  • Üretilen kod boş mu?
  • Temel HTML etiketleri var mı? <!DOCTYPE> / viewport meta?
  • HTML < ve > dengesi
  • CSS { } (ve inline <style>) dengesi

{"ok": bool, "issues": [...], "warnings": [...]} döner. issues ok'u false yapar; warnings sadece öneridir.

Ortam değişkenleri (backend)

değişken varsayılan
CHIEFUI_CKPT checkpoints/ckpt.pt
CHIEFUI_TOKENIZER checkpoints/tokenizer.json
CHIEFUI_DEVICE cuda varsa cuda, yoksa cpu
CHIEFUI_DB database/history.db

ChiefUI Assistant

Repo →

Clone this wiki locally