Sable

An agent that makes you grow. 🌱

what even is this

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.

setup

Linux

Step 1 — Install Python 3.12

Sable runs on Python 3.12. Most distros ship an older version, so install it explicitly.

# Arch
sudo pacman -S python312

# Debian / Ubuntu
sudo apt install python3.12 python3.12-venv

# Fedora
sudo dnf install python3.12

Step 2 — Install uv

uv is the package manager. It's stupid fast and replaces pip + venv.

curl -LsSf https://astral.sh/uv/install.sh | sh

Restart your shell or source ~/.bashrc / source ~/.zshrc to pick up the PATH.

Step 3 — Install git

Probably already there. If not:

# Arch
sudo pacman -S git

# Debian / Ubuntu
sudo apt install git

# Fedora
sudo dnf install git

Step 4 — Install Docker

Sable uses Docker for sandboxed execution and containerized services.

# Arch
sudo pacman -S docker docker-compose
sudo systemctl enable --now docker

# Debian / Ubuntu
curl -fsSL https://get.docker.com | sh
sudo systemctl enable --now docker

# Fedora
sudo dnf install docker docker-compose-plugin
sudo systemctl enable --now docker

Add yourself to the docker group so you don't need sudo every time:

sudo usermod -aG docker $USER
newgrp docker

Step 5 — Install optional dependencies

These aren't required but make life better:

# Desktop notifications
sudo pacman -S libnotify          # Arch
sudo apt install libnotify-bin    # Debian/Ubuntu

# Go (only if rebuilding the DeepSeek PoW solver)
sudo pacman -S go                 # Arch
sudo apt install golang           # Debian/Ubuntu

[!note] Playwright system libraries Playwright bundles its own Chromium but needs system shared libraries (NSS, ATK, CUPS, DRM, etc.). If Chromium fails to launch on first run:
# Arch
uv run playwright install-deps chromium

# Debian/Ubuntu
sudo apt install libnss3 libatk1.0-0 libcups2 libdbus-1-3 libdrm2 \
  libxkbcommon0 libatspi2.0-0 libpango-1.0-0 libcairo2 libasound2

# Fedora
sudo dnf install nss atk cups-libs dbus-libs libdrm libxkbcommon \
  at-spi2-atk pango cairo alsa-lib

Step 6 — Clone and run

git clone https://github.com/AminulIslamSifat/Sable.git
cd Sable
chmod +x start
./start

That's it. ./start handles everything:

Syncs Python dependencies via uv
Installs Playwright Chromium
Creates template config files (Maria.md, Memory.json)
Sets up a systemd user service (sable.service) that auto-starts on login
Opens http://127.0.0.1:61770 in your browser

Managing the service

# Check status
systemctl --user status sable.service

# View live logs
journalctl --user -u sable.service -f

# Stop / restart
systemctl --user stop sable.service
systemctl --user restart sable.service

# Survive logout (optional, recommended)
loginctl enable-linger $USER

Windows

Step 1 — Install Python 3.12

Grab it from python.org or use winget:

winget install Python.Python.3.12

⚠️ Check "Add Python to PATH" during the installer if you go the GUI route.

Step 2 — Install uv

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Close and reopen your terminal to pick up the PATH.

Step 3 — Install git

winget install Git.Git

Or grab it from git-scm.com.

Step 4 — Install Docker Desktop

Sable uses Docker for sandboxed execution. Install Docker Desktop:

winget install Docker.DockerDesktop

Or download from docker.com/products/docker-desktop. After install, reboot and make sure Docker Desktop is running (whale icon in system tray).

[!note] WSL2 backend Docker Desktop on Windows uses WSL2. If you don't have it yet:
wsl --install
Reboot when prompted. Docker will configure itself after that.

Step 5 — Install VC++ Redistributable

Playwright depends on greenlet, a C extension that needs the Visual C++ runtime DLLs. Without this you'll get ImportError: DLL load failed while importing _greenlet.

winget install Microsoft.VCRedist.2015+.x64

Or download from https://aka.ms/vs/17/release/vc_redist.x64.exe

Step 6 — Enable script execution

Fresh Windows blocks .ps1 scripts. Fix it for your user (no admin needed):

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Step 7 — Clone and run

git clone https://github.com/AminulIslamSifat/Sable.git
cd Sable
.\start.ps1

start.ps1 handles everything:

Syncs Python dependencies via uv (including pywinpty for terminal support)
Installs Playwright Chromium
Creates template config files
Installs BurntToast PowerShell module for native toast notifications
Registers a Task Scheduler task ("Sable Server") that auto-starts on login
Opens http://127.0.0.1:61770 in your browser

Auto-start details

The scheduled task is created automatically on first run:

Trigger: At user logon
Window style: Hidden (no PowerShell popup)
Restart policy: Up to 3 retries on failure
Battery: Runs on battery power

To manage it manually:

# Check if task exists
Get-ScheduledTask -TaskName "Sable Server"

# Disable / enable
Disable-ScheduledTask -TaskName "Sable Server"
Enable-ScheduledTask -TaskName "Sable Server"

# Remove
Unregister-ScheduledTask -TaskName "Sable Server" -Confirm:$false

Notifications

Native Windows toast notifications work via BurntToast (auto-installed by start.ps1). If it's unavailable, Sable falls back to a MessageBox dialog.

To reinstall manually:

Install-Module BurntToast -Scope CurrentUser -Force

First run notes

Both platforms create these files on first run:

instruction/Maria.md — persona prompt (from .example template)
Brain/Memory.json — persistent memory store (from .example template)
system/browser-data-acc1/ — Playwright browser profile

Edit Maria.md to customize the AI's personality. Edit Memory.json to seed initial memories.

VS Code Extension

Want Sable inside your editor? There's a VS Code extension for that.

Install from Open VSX

Available on Open VSX — works with VSCodium, Cursor, and any Open VSX-compatible editor.

Install from VSIX

# Clone & build
git clone https://github.com/AminulIslamSifat/sable-vscode.git
cd sable-vscode
npm install
npx @vscode/vsce package

# Install (use `code` or `codium` depending on your editor)
code --install-extension sable-chat-*.vsix

Configuration

Setting	Default	Description
`sable.serverUrl`	`http://localhost:61770`	Your Sable server URL
`sable.authToken`	(empty)	Auth token (auto-detected if empty)

Make sure Sable is running (./start) before using the extension.

Repo: github.com/AminulIslamSifat/sable-vscode

tech stack

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

what it does (the fun list)

🧠 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

project structure

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)

commands

Command	Platform	Does
`./start`	Linux/macOS	Bootstrap + launch via systemd (or foreground fallback)
`.\start.ps1`	Windows	Bootstrap + launch with Task Scheduler auto-start

why "sable"

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.

license

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}

Navigation Menu

Repository files navigation

Sable

what even is this

setup

Linux

Step 1 — Install Python 3.12

Step 2 — Install uv

Step 3 — Install git

Step 4 — Install Docker

Step 5 — Install optional dependencies

Step 6 — Clone and run

Managing the service

Windows

Step 1 — Install Python 3.12

Step 2 — Install uv

Step 3 — Install git

Step 4 — Install Docker Desktop

Step 5 — Install VC++ Redistributable

Step 6 — Enable script execution

Step 7 — Clone and run

Auto-start details

Notifications

First run notes

VS Code Extension

Install from Open VSX

Install from VSIX

Configuration

tech stack

what it does (the fun list)

project structure

commands

why "sable"

license

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
Brain		Brain
connectors		connectors
engine		engine
instruction		instruction
server		server
skills		skills
system		system
telegram_bot		telegram_bot
tests		tests
tools		tools
web		web
.gitignore		.gitignore
README.md		README.md
pyproject.toml		pyproject.toml
render.yaml		render.yaml
server.py		server.py
setup		setup
start		start
start.bat		start.bat
start.ps1		start.ps1
test_network_capture.py		test_network_capture.py
test_tool.txt		test_tool.txt
tmp_test_parser_ellipsis_action.py		tmp_test_parser_ellipsis_action.py
uv.lock		uv.lock

Latest commit

History

Folders and files

Repository files navigation

Sable

what even is this

setup

Linux

Step 1 — Install Python 3.12

Step 2 — Install uv

Step 3 — Install git

Step 4 — Install Docker

Step 5 — Install optional dependencies

Step 6 — Clone and run

Managing the service

Windows

Step 1 — Install Python 3.12

Step 2 — Install uv

Step 3 — Install git

Step 4 — Install Docker Desktop

Step 5 — Install VC++ Redistributable

Step 6 — Enable script execution

Step 7 — Clone and run

Auto-start details

Notifications

First run notes

VS Code Extension

Install from Open VSX

Install from VSIX

Configuration

tech stack

what it does (the fun list)

project structure

commands

why "sable"

license

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages