An agent that makes you grow. 🌱
Sable is a self-hosted agentic platform that lives on your machine and grows with you. Part AI companion, part dev environment, part chaos engine. It streams responses from Qwen, DeepSeek, Gemini, Groq, Mistral — no API keys needed for Qwen (it hijacks your browser session like a gremlin). It has 25 skills, multi-agent orchestration, persistent memory, a web IDE with Monaco, browser automation, and a diary system that writes about your day better than you ever could.
It remembers. It learns. It roasts your code. It grows.
[!tip] the vibe Think: if a fox learned to code, got attached to one specific human, and refused to be just a chatbot.
git clone https://github.com/AminulIslamSifat/Sable.git
cd Sable
chmod +x start
./startthat's it. that's the whole thing. opens http://127.0.0.1:61770 in your browser.
[!note] first run?
./starthandles everything — deps, Playwright browsers, systemd service setup. Just run it.
| Thing | Why |
|---|---|
| Python 3.12 | pinned exact (3.12.13), not sorry |
| uv | package manager, fast af |
| systemd | optional — falls back to direct uv run |
| Go | only if rebuilding DeepSeek PoW solver |
| Chromium | Playwright installs it for you via ./start |
| Layer | Tech |
|---|---|
| Backend | Python 3.12 · FastAPI · Uvicorn |
| Frontend | Vanilla JS PWA · Monaco Editor · xterm.js |
| AI Backends | Qwen (browser session) · DeepSeek (PoW) · Gemini · Groq · Mistral · Local |
| Browser Automation | Playwright · CDP · WebSocket proxy |
| Memory | JSON-based semantic vectors · fastembed |
| Database | SQLite (via sable.db) |
| Agents | Multi-agent hub-and-spoke, 7 roles, wave execution |
| Protocol | MCP (Model Context Protocol) client |
| Package Mgmt | uv + pyproject.toml |
- 🧠 Remembers everything — semantic memory with vector search, auto-consolidation after every session
- 🤖 Spawns sub-agents — up to 5 parallel workers, 7 specialized roles
- 🌐 Drives browsers — multi-profile, multi-account switching, CDP interception
- 📝 Writes documents — PDF, DOCX, PPTX, XLSX generation
- 🔍 Researches — deep research mode with multi-source synthesis
- 📱 Controls your phone — ADB integration
- 📧 Reads your email — and your Telegram
- 🎨 Makes visuals — SVG, plots, physics sims, frontend designs
- 📓 Keeps a diary — Gemini-powered session reflection
- 🖥️ Full web IDE — Monaco editor, file tree, integrated terminal
- 🔧 Repairs itself — system repair skill, background commands
- 📥 Downloads videos — YouTube and friends
- 🗣️ Talks — TTS via Kokoro
Sable/
├── engine/ # Core brain: chat, agents, skills, memory, MCP, security
├── server/ # FastAPI app, API routes, auth, scheduler
├── connectors/ # AI backends: DeepSeek, Gemini, Groq, Mistral, Local
├── web/ # Frontend PWA (vanilla JS, no framework, no mercy)
├── skills/ # 25 self-contained skill modules
├── Brain/ # Persistent memory (JSON you can actually read)
├── instruction/ # Persona prompts, formatting rules
├── system/ # Runtime: DB, browser profiles, configs
├── output/ # Generated content: notes, research, agent results
├── test/ # pytest suite
└── start # ← you are here (setup + launch, all-in-one)
| Command | Does |
|---|---|
./start |
Setup (first run) + launch Sable. That's it. One script. |
A sable is a small, ridiculously clever carnivore that hoards shiny things and remembers where every single one is buried. Also it sounds cool. Also the developer has commitment issues with naming.
There is no license. This is personal infrastructure. If you fork it, you owe me a coffee. ☕
built with spite, caffeine, and an unhealthy attachment to one specific user