fusefable 0.3.1__tar.gz → 0.4.0__tar.gz

{fusefable-0.3.1 → fusefable-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fusefable
-Version: 0.3.1
+Version: 0.4.0
 Summary: Fuse multiple AI models and judge the best answer for coding
 Author: proultrax9
 License: MIT
@@ -24,6 +24,8 @@ Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
 Requires-Dist: respx>=0.21; extra == "dev"
 Provides-Extra: mcp
 Requires-Dist: mcp>=1.2; extra == "mcp"
+Provides-Extra: app
+Requires-Dist: pywebview>=5; extra == "app"
 Dynamic: license-file
 
 # Fuse Fable
@@ -45,6 +47,7 @@ and as a **subagent / pipe** (callable by other tools and scripts).
 ```bash
 pip install fusefable            # core
 pip install "fusefable[mcp]"     # if you want the MCP server
+pip install "fusefable[app]"     # if you want the desktop window (fusefable gui)
 ```
 From source:
 ```bash
@@ -75,6 +78,17 @@ setx OPENROUTER_API_KEY "sk-..."      # Windows (open a new terminal afterwards)
 
 Config is stored at `~/.fusefable/config.yaml`.
 
+## 0) Use as a desktop app
+
+A native window (like Cursor/VS Code), no browser tab — chat UI with toggles for
+compress / ensemble / cache and a model filter:
+```bash
+pip install "fusefable[app]"
+fusefable gui
+```
+Built on PyWebView (uses the system webview), so it's lightweight and cross-platform.
+Requires a completed `fusefable config`.
+
 ## 1) Use as a CLI
 ```bash
 fusefable ask "Write a quicksort function in Python"

{fusefable-0.3.1 → fusefable-0.4.0}/README.md

@@ -17,6 +17,7 @@ and as a **subagent / pipe** (callable by other tools and scripts).
 ```bash
 pip install fusefable            # core
 pip install "fusefable[mcp]"     # if you want the MCP server
+pip install "fusefable[app]"     # if you want the desktop window (fusefable gui)
 ```
 From source:
 ```bash
@@ -47,6 +48,17 @@ setx OPENROUTER_API_KEY "sk-..."      # Windows (open a new terminal afterwards)
 
 Config is stored at `~/.fusefable/config.yaml`.
 
+## 0) Use as a desktop app
+
+A native window (like Cursor/VS Code), no browser tab — chat UI with toggles for
+compress / ensemble / cache and a model filter:
+```bash
+pip install "fusefable[app]"
+fusefable gui
+```
+Built on PyWebView (uses the system webview), so it's lightweight and cross-platform.
+Requires a completed `fusefable config`.
+
 ## 1) Use as a CLI
 ```bash
 fusefable ask "Write a quicksort function in Python"

fusefable-0.4.0/fusefable/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.4.0"

{fusefable-0.3.1 → fusefable-0.4.0}/fusefable/cli.py

@@ -131,5 +131,13 @@ def mcp():
     run_mcp()
 
 
+@app.command()
+def gui():
+    """เปิดหน้าต่างโปรแกรม (desktop window) แบบ Cursor/VS Code."""
+    cfg = _load_or_die()
+    from fusefable.desktop import run_app
+    run_app(cfg)
+
+
 if __name__ == "__main__":
     app()

fusefable-0.4.0/fusefable/desktop.py

@@ -0,0 +1,82 @@
+"""Desktop window (PyWebView) — หน้าต่างโปรแกรมแบบ Cursor/VS Code.
+
+ห่อ web UI ด้วย webview ของระบบ; JS เรียก Python ผ่าน js_api (ไม่ต้องมี web server).
+แยก answer_to_dict / run_query (test ได้) ออกจาก run_app (เปิดหน้าต่างจริง).
+"""
+from __future__ import annotations
+import asyncio
+from typing import Optional
+from fusefable.config import Config
+from fusefable.core import fuse
+from fusefable.models import FinalAnswer
+
+
+def answer_to_dict(ans: FinalAnswer) -> dict:
+    """แปลง FinalAnswer → dict ส่งให้ JS."""
+    d = {
+        "answer": ans.text,
+        "chosen_model": ans.chosen_model,
+        "reason": ans.reason,
+        "cost_usd": ans.cost_usd,
+        "cached": ans.cached,
+        "budget_warning": ans.budget_warning,
+        "candidates": [{"model": c.model, "text": c.text}
+                       for c in ans.all_completions],
+    }
+    if ans.compression is not None:
+        c = ans.compression
+        d["compression"] = {
+            "original_chars": c.original_chars,
+            "final_chars": c.final_chars,
+            "saved_pct": round(c.saved_pct, 1),
+            "method": c.method,
+        }
+    return d
+
+
+def _models_from_payload(payload: dict) -> Optional[list[str]]:
+    raw = payload.get("models")
+    if not raw:
+        return None
+    if isinstance(raw, str):
+        items = [m.strip() for m in raw.split(",") if m.strip()]
+        return items or None
+    return list(raw) or None
+
+
+def run_query(cfg: Config, payload: dict) -> dict:
+    """รัน fuse จาก payload ของ UI. คืน dict (มี key 'error' ถ้าพัง) — ไม่โยน."""
+    try:
+        ans = asyncio.run(fuse(
+            cfg, payload["question"],
+            models=_models_from_payload(payload),
+            compress=payload.get("compress"),
+            ensemble=payload.get("ensemble"),
+            use_cache=payload.get("cache"),
+        ))
+        return answer_to_dict(ans)
+    except Exception as e:  # noqa: BLE001 — ส่ง error กลับ UI ไม่ให้หน้าต่างค้าง
+        return {"error": str(e)}
+
+
+class Api:
+    """js_api ให้ฝั่ง JS เรียก (pywebview.api.ask(...))."""
+
+    def __init__(self, cfg: Config):
+        self.cfg = cfg
+
+    def ask(self, payload: dict) -> dict:
+        return run_query(self.cfg, payload)
+
+
+def run_app(cfg: Config) -> None:
+    """เปิดหน้าต่าง desktop. ต้องติดตั้ง: pip install 'fusefable[app]'."""
+    try:
+        import webview
+    except ImportError:
+        raise SystemExit("ติดตั้งก่อน: pip install 'fusefable[app]'")
+    from fusefable.web import INDEX_HTML
+    api = Api(cfg)
+    webview.create_window("Fuse Fable", html=INDEX_HTML, js_api=api,
+                          width=960, height=720, min_size=(640, 480))
+    webview.start()

fusefable-0.4.0/fusefable/web.py

@@ -0,0 +1,115 @@
+"""UI ของหน้าต่าง desktop (HTML/CSS/JS ฝังในไฟล์เดียว — ไม่พึ่ง network)."""
+
+INDEX_HTML = r"""<!DOCTYPE html>
+<html lang="th">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Fuse Fable</title>
+<style>
+  :root { --bg:#0f1115; --panel:#171a21; --panel2:#1f2430; --line:#2a3040;
+          --text:#e6e9ef; --muted:#8b93a7; --accent:#5b9cff; --green:#3fb950; }
+  * { box-sizing:border-box; }
+  html,body { margin:0; height:100%; }
+  body { background:var(--bg); color:var(--text); font:14px/1.55 -apple-system,Segoe UI,Roboto,sans-serif;
+         display:flex; flex-direction:column; }
+  header { padding:12px 16px; border-bottom:1px solid var(--line); display:flex;
+           align-items:center; gap:10px; background:var(--panel); }
+  header .dot { width:9px; height:9px; border-radius:50%; background:var(--green); }
+  header h1 { font-size:15px; margin:0; font-weight:600; }
+  header .sub { color:var(--muted); font-size:12px; margin-left:auto; }
+  #opts { display:flex; gap:14px; align-items:center; flex-wrap:wrap;
+          padding:8px 16px; border-bottom:1px solid var(--line); background:var(--panel);
+          font-size:13px; color:var(--muted); }
+  #opts label { display:flex; gap:5px; align-items:center; cursor:pointer; }
+  #opts input[type=text] { background:var(--panel2); border:1px solid var(--line);
+          color:var(--text); border-radius:6px; padding:4px 8px; font-size:12px; width:200px; }
+  #msgs { flex:1; overflow-y:auto; padding:16px; display:flex; flex-direction:column; gap:12px; }
+  .bubble { max-width:88%; padding:10px 13px; border-radius:12px; white-space:pre-wrap;
+            word-wrap:break-word; }
+  .user { align-self:flex-end; background:var(--accent); color:#fff; border-bottom-right-radius:3px; }
+  .bot { align-self:flex-start; background:var(--panel2); border:1px solid var(--line);
+         border-bottom-left-radius:3px; }
+  .meta { color:var(--muted); font-size:12px; margin-top:7px; padding-top:7px;
+          border-top:1px solid var(--line); }
+  .err { background:#3a1d1d; border-color:#5c2b2b; color:#ffb4b4; }
+  details { margin-top:6px; } summary { cursor:pointer; color:var(--accent); font-size:12px; }
+  details pre { background:var(--bg); padding:8px; border-radius:6px; overflow:auto;
+                font-size:12px; border:1px solid var(--line); }
+  #inbar { display:flex; gap:8px; padding:12px 16px; border-top:1px solid var(--line);
+           background:var(--panel); }
+  #q { flex:1; resize:none; height:44px; max-height:160px; background:var(--panel2);
+       border:1px solid var(--line); color:var(--text); border-radius:8px; padding:10px 12px;
+       font:14px inherit; }
+  #send { background:var(--accent); color:#fff; border:0; border-radius:8px; padding:0 18px;
+          font-weight:600; cursor:pointer; }
+  #send:disabled { opacity:.5; cursor:default; }
+  .spin { color:var(--muted); font-size:13px; }
+</style>
+</head>
+<body>
+  <header>
+    <span class="dot"></span><h1>Fuse Fable</h1>
+    <span class="sub">fan-out · judge/ensemble · best answer</span>
+  </header>
+  <div id="opts">
+    <label><input type="checkbox" id="compress"> compress</label>
+    <label><input type="checkbox" id="ensemble"> ensemble</label>
+    <label><input type="checkbox" id="cache"> cache</label>
+    <input type="text" id="models" placeholder="models (comma, ว่าง=ทุกตัว)">
+  </div>
+  <div id="msgs"></div>
+  <div id="inbar">
+    <textarea id="q" placeholder="พิมพ์คำถาม… (Enter ส่ง, Shift+Enter ขึ้นบรรทัด)"></textarea>
+    <button id="send">Send</button>
+  </div>
+<script>
+  const msgs = document.getElementById('msgs');
+  const q = document.getElementById('q');
+  const send = document.getElementById('send');
+
+  function esc(s){ const d=document.createElement('div'); d.textContent=s; return d.innerHTML; }
+  function add(cls, html){ const el=document.createElement('div'); el.className='bubble '+cls;
+    el.innerHTML=html; msgs.appendChild(el); msgs.scrollTop=msgs.scrollHeight; return el; }
+
+  function renderBot(r){
+    if(r.error){ add('bot err', '⚠️ '+esc(r.error)); return; }
+    let meta = [];
+    meta.push(r.chosen_model==='ensemble' ? 'ensemble' : 'from '+esc(r.chosen_model));
+    meta.push(r.cached ? 'cached, $0' : '$'+(r.cost_usd||0).toFixed(4));
+    if(r.compression) meta.push('compressed '+r.compression.original_chars+'→'+
+        r.compression.final_chars+' (~'+r.compression.saved_pct+'%)');
+    let cand = '';
+    if(r.candidates && r.candidates.length){
+      cand = '<details><summary>'+r.candidates.length+' candidates</summary>'+
+        r.candidates.map(c=>'<div><b>'+esc(c.model)+'</b><pre>'+esc(c.text)+'</pre></div>').join('')+
+        '</details>';
+    }
+    let warn = r.budget_warning ? '<div class="meta">⚠️ '+esc(r.budget_warning)+'</div>' : '';
+    add('bot', esc(r.answer) + warn + '<div class="meta">'+meta.join(' · ')+'</div>' + cand);
+  }
+
+  async function ask(){
+    const text = q.value.trim(); if(!text) return;
+    add('user', esc(text)); q.value='';
+    send.disabled=true;
+    const spin = add('bot spin', 'กำลังฟิวชั่นหลายโมเดล…');
+    const payload = { question:text,
+      compress:document.getElementById('compress').checked,
+      ensemble:document.getElementById('ensemble').checked,
+      cache:document.getElementById('cache').checked,
+      models:document.getElementById('models').value };
+    try {
+      const r = await window.pywebview.api.ask(payload);
+      spin.remove(); renderBot(r);
+    } catch(e){ spin.remove(); add('bot err','⚠️ '+esc(String(e))); }
+    send.disabled=false; q.focus();
+  }
+
+  send.addEventListener('click', ask);
+  q.addEventListener('keydown', e=>{ if(e.key==='Enter' && !e.shiftKey){ e.preventDefault(); ask(); }});
+  q.focus();
+</script>
+</body>
+</html>
+"""

{fusefable-0.3.1 → fusefable-0.4.0}/fusefable.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fusefable
-Version: 0.3.1
+Version: 0.4.0
 Summary: Fuse multiple AI models and judge the best answer for coding
 Author: proultrax9
 License: MIT
@@ -24,6 +24,8 @@ Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
 Requires-Dist: respx>=0.21; extra == "dev"
 Provides-Extra: mcp
 Requires-Dist: mcp>=1.2; extra == "mcp"
+Provides-Extra: app
+Requires-Dist: pywebview>=5; extra == "app"
 Dynamic: license-file
 
 # Fuse Fable
@@ -45,6 +47,7 @@ and as a **subagent / pipe** (callable by other tools and scripts).
 ```bash
 pip install fusefable            # core
 pip install "fusefable[mcp]"     # if you want the MCP server
+pip install "fusefable[app]"     # if you want the desktop window (fusefable gui)
 ```
 From source:
 ```bash
@@ -75,6 +78,17 @@ setx OPENROUTER_API_KEY "sk-..."      # Windows (open a new terminal afterwards)
 
 Config is stored at `~/.fusefable/config.yaml`.
 
+## 0) Use as a desktop app
+
+A native window (like Cursor/VS Code), no browser tab — chat UI with toggles for
+compress / ensemble / cache and a model filter:
+```bash
+pip install "fusefable[app]"
+fusefable gui
+```
+Built on PyWebView (uses the system webview), so it's lightweight and cross-platform.
+Requires a completed `fusefable config`.
+
 ## 1) Use as a CLI
 ```bash
 fusefable ask "Write a quicksort function in Python"

{fusefable-0.3.1 → fusefable-0.4.0}/fusefable.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ fusefable/compressor.py
 fusefable/config.py
 fusefable/core.py
 fusefable/cost.py
+fusefable/desktop.py
 fusefable/ensemble.py
 fusefable/fanout.py
 fusefable/fusion.py
@@ -16,6 +17,7 @@ fusefable/judge.py
 fusefable/mcp_server.py
 fusefable/models.py
 fusefable/routing.py
+fusefable/web.py
 fusefable/wizard.py
 fusefable.egg-info/PKG-INFO
 fusefable.egg-info/SOURCES.txt
@@ -36,6 +38,7 @@ tests/test_compressor.py
 tests/test_config.py
 tests/test_core.py
 tests/test_cost.py
+tests/test_desktop.py
 tests/test_ensemble.py
 tests/test_fanout.py
 tests/test_fusion.py

{fusefable-0.3.1 → fusefable-0.4.0}/fusefable.egg-info/requires.txt

@@ -2,6 +2,9 @@ httpx>=0.27
 typer>=0.12
 pyyaml>=6.0
 
+[app]
+pywebview>=5
+
 [dev]
 pytest>=8.0
 pytest-asyncio>=0.23

{fusefable-0.3.1 → fusefable-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fusefable"
-version = "0.3.1"
+version = "0.4.0"
 description = "Fuse multiple AI models and judge the best answer for coding"
 readme = "README.md"
 license = { text = "MIT" }
@@ -27,6 +27,7 @@ Repository = "https://github.com/proultrax9/fusefable"
 [project.optional-dependencies]
 dev = ["pytest>=8.0", "pytest-asyncio>=0.23", "respx>=0.21"]
 mcp = ["mcp>=1.2"]
+app = ["pywebview>=5"]
 
 [project.scripts]
 fusefable = "fusefable.cli:app"

fusefable-0.4.0/tests/test_desktop.py

@@ -0,0 +1,49 @@
+import pytest
+from fusefable import desktop
+from fusefable.models import FinalAnswer, Completion
+from fusefable.compressor import CompressionResult
+
+
+def test_answer_to_dict_includes_meta():
+    ans = FinalAnswer(text="best", chosen_model="gpt", reason="r", cost_usd=0.02,
+                      all_completions=[Completion(model="gpt", text="best")],
+                      compression=CompressionResult("x", 1000, 400, "llm"))
+    d = desktop.answer_to_dict(ans)
+    assert d["answer"] == "best"
+    assert d["chosen_model"] == "gpt"
+    assert d["candidates"][0]["model"] == "gpt"
+    assert d["compression"]["method"] == "llm"
+    assert d["compression"]["saved_pct"] == 60.0
+
+
+def test_models_from_payload_parses_csv():
+    assert desktop._models_from_payload({"models": "a, b ,c"}) == ["a", "b", "c"]
+    assert desktop._models_from_payload({"models": ""}) is None
+    assert desktop._models_from_payload({}) is None
+
+
+def test_run_query_calls_fuse_and_serializes(monkeypatch):
+    captured = {}
+
+    async def fake_fuse(cfg, question, models=None, compress=None,
+                        ensemble=None, use_cache=None):
+        captured.update(question=question, models=models, compress=compress,
+                        ensemble=ensemble, use_cache=use_cache)
+        return FinalAnswer(text="hi", chosen_model="m")
+
+    monkeypatch.setattr(desktop, "fuse", fake_fuse)
+    out = desktop.run_query("CFG", {"question": "Q", "models": "a,b",
+                                    "compress": True, "ensemble": False, "cache": True})
+    assert out["answer"] == "hi"
+    assert captured["question"] == "Q"
+    assert captured["models"] == ["a", "b"]
+    assert captured["compress"] is True
+    assert captured["use_cache"] is True
+
+
+def test_run_query_returns_error_on_failure(monkeypatch):
+    async def boom(*a, **k):
+        raise RuntimeError("kaboom")
+    monkeypatch.setattr(desktop, "fuse", boom)
+    out = desktop.run_query("CFG", {"question": "Q"})
+    assert out["error"] == "kaboom"

fusefable-0.3.1/fusefable/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.3.1"