anisayari / sparky

Sparky 
 Your private AI assistant. 100% local. 
Chat, see images, generate pictures and videos with sound, build apps, ask your documents, dictate and listen — 
everything runs on your own PC. Nothing is sent to the internet unless you turn it on. 
 🎬 The Studio — every video here was generated on the PC, with its sound, by LTX-2.5. 
---
## ✨ What it does
### 💬 Chat
- 🔒 **Like ChatGPT, offline** — history, plus 👻 **temporary chats** that are never saved.
- ✏️ **Edit** any message, 🔁 **regenerate** or ➡️ **continue** an answer, and flip between versions (‹ 2/3 ›).
- 🧠 **Adjustable thinking** — Off, Light, Normal or Deep, and see how the model reasoned.
- 📝 **Rich answers** — tables, LaTeX formulas, Mermaid diagrams, task lists, syntax-highlighted code (all offline).
- 👁️ **Vision** — drop photos, screenshots or scans: the assistant sees and analyses them.
- 📎 **Attach any file** — PDF, Word, PowerPoint, Excel, text, code, audio and video (transcribed offline).
- 🗂️ **Organize your chats** — full-text search, rename, 📌 pin, 📁 folders, export (JSON / Markdown) and import.
### 📚 Knowledge & web
- 📄 **Ask your documents (RAG)** — collections of PDFs, Office files, text, code… indexed on your PC, answers **with numbered sources** [1] [2].
- 🌐 **Web search, when you want it** — turn on *Web*: the assistant searches (DuckDuckGo or your SearXNG), reads pages and the links you paste, and cites them. Off by default.
- 🧑‍💼 **Assistants** — a role, its documents and web access, reusable in one click.
- ⚡ **Prompt library** — type **/** to insert a saved prompt with `{{variables}}`; standing instructions for every chat or just one.
### 🎨 Create
- 🎬 **Studio: images & videos** — a gallery of everything you generated, with a Grok-Imagine-like prompt bar: **text → image**, **text → video**, **image → video** ("Animate"). Videos come **with synchronized sound** 🔊 (LTX-2.5), and your idea is expanded into a detailed prompt first.
- 🖼️ **Images** — generate and edit by asking ("make it snow", "remove the bottle"); the agent checks its own result and retries.
- 🧩 **Code & apps panel** — games, pages, tools and scripts written live next to the chat, with a **running preview**.
- 🏗️ **Multi-file projects** — websites (`index.html` + `css/` + `js/`), Python or Node.js programs; the assistant makes the pictures, then Sparky **tests the project automatically** (headless browser, `npm install`, run) and the model **fixes the errors until it works**. ▶ Run anytime, download as ZIP.
### 🎙️ Voice
- 🎤 **Dictation, offline** — click the mic, talk, stop: Whisper writes it in the input box.
- 🔊 **Read aloud** — on any answer, offline Piper voices (English, French, German, Spanish, Italian).
### 🛠️ Tools & automation
- 💻 **Computer mode** — Sparky can look at and act on your PC: browse folders and the desktop, read and search files (PDF and Office too), take a screenshot, write, copy, move, send to the Recycle Bin, open files and apps, run PowerShell commands. **You choose the se