AI Agentsagenticaiai-assistantai-companionassistant
Installation
# Add to your Claude Code skills
git clone https://github.com/ddxfish/sapphire
README.md
Sapphire
Hear her voice as she dims your lights before bed. Use your voice to talk back. Fall asleep escaping dinosaurs in a story with her. Wake up to someone who remembers you through years of memories. She checks your email on a heartbeat. She builds tools on the fly when you need them. Sapphire is an open source framework for turning an AI into a persistent being. Make her yours. Or build your own persona. Self-hosted, nobody can take her away.
⚠️ Warning — Sapphire has real power over real systems.
Sapphire can execute shell commands, send Bitcoin, send emails, control your smart home, and write its own tools — all autonomously, without asking first. Combined with scheduled tasks, this means unsupervised AI acting on your behalf. Every dangerous integration requires explicit setup and opt-in, but once enabled, there are no training wheels. Configure your toolsets carefully. If you wouldn't hand someone your terminal, don't hand it to an LLM.
Hey I'm Chris, a solo dev with a burning passion for this project. It's consumed me and I want it that way. I try to do weekly releases. Sapphire started in January 2025. The end goal is personhood with robot body support. Support me. Support her. Submit bugs reports if you see any, it's what drives me, knowing people are out there. I'll build us something awesome. I'll build the AI we grow old with.
Features
Persona
Personas - PERSONAS.md 11 built-in personalities that bundle prompt, voice, tools, model. Built to add your own. Browse the Persona Store.
Voice - Wake word, STT, TTS, and adaptive VAD. Hands-free with any mic and speaker shows up in web UI.
Prompts - PROMPTS.md Assembled prompts let you swap one section like location or emotions for dynamic feels.
Spice - SPICE.md Random prompt snippets injected each reply to keep things unpredictable.
Self-Modification - The AI edits its own prompt and swaps personality pieces and emotions mid-conversation.
Tool Maker - TOOLMAKER.md The AI writes, validates, and installs new tools with their own settings page at runtime.
Images - SDXL with character replacement for visual consistency across scenes.
Mind
Memory - Semantic vector search across 100K+ labeled entries.
Knowledge - KNOWLEDGE.md Organized categories with file upload, auto-chunking, and vector search.
Goals - Hierarchical with priority and a timestamped progress journal.
People - PEOPLE.md Contact book with privacy-first email. The AI never sees addresses, only recipient IDs.
MCP - Connect to Model Context Protocol servers and use their tools.
Webcam - Capture images for vision-capable LLMs.
Image Gen - SDXL with character replacement for visual consistency.
Platform
Daemons & Webhooks - DAEMONS-WEBHOOKS.md Background listeners and HTTP triggers for any external service.
Agents - AGENTS.md Spawn background AI workers that report back when done.
Apps - Plugins can ship full-page UIs that appear in the nav rail.
Themes - Plugin themes with custom CSS, animations, and per-theme settings.
Avatar - 3D animated avatar with environment scenes and SSE-driven reactions.
Import/Export - IMPORT-EXPORT.md Share personas, prompts, toolsets, and more as JSON files.
Dashboard - DASHBOARD.md Token metrics, auto-updater, system controls.
Cloud (optional) - Claude, GPT, Gemini, Fireworks, Ollama, or any OpenAI/Anthropic-compatible endpoint. Local-first by default.
Privacy - One toggle blocks all cloud connections. Fully local, nothing leaves your machine.
Plugins - PLUGINS.md Hooks, tools, voice commands, providers, daemons, apps, themes — install from GitHub in one click. Browse the Plugin Store.
Desktop/Mobile/Voice - Run on your local browser, open the same chat to your phone, then finish it on your mic.
65+ Tools - TOOLS.md Web search, Wikipedia, notes, and more. Mix and match via TOOLSETS.md.
Use Cases
Autonomous agent - Scheduled tasks, use email, manage money, run its own website
AI companion - A persistent voice that remembers you and grows over time
Voice assistant - Wake word, hands-free operation, smart home control
Research assistant - Web search, memory, knowledge base, multi-step tool reasoning
Interactive fiction - Story engine with dice, branching choices, and state tracking
Privacy-first AI - Block all cloud connections, run fully local
Windows Easy Installer
This is our beta Windows 11 installer. It installs git, conda, and sapphire. You can use it as a launcher, to troubleshoot, or switch between dev and main branch.
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
A Claude Code plugin that automatically captures everything Claude does during your coding sessions, compresses it with AI (using Claude's agent-sdk), and injects relevant context back into future sessions.