selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

sapphire logo

Self-host sapphire

v2.13.1

Agentic AI companion with voice, memory, tools

ReleaseOpen SourceAGPL-3.0
Updated8 hours ago
LanguagePython
Setup difficultyAdvanced
MobileResponsive
Stars
320
CPU
Fast CPU (passmark)
RAM
16GB+ system RAM with TTS STT; 32GB+ for local LLM
Storage
8GB+ hard drive space
Port
8073 (Web UI and API)
Docker
ghcr.io/ddxfish/sapphire
Install with Docker Compose
Main chat window where you talk to SapphireMain chat window sidebar exposedPersona page to assemble prompt, toolsets, spices, voicesPrompt pieces let you swap goals/character without rewriting the whole promptToolsets page to enable the tools you wantMemory list with tags, scopes, and duplicate removalMain dashboard with widgets (plugin capable)Plugins page to add and remove capabilitiesPlugin store to download community pluginsSettings > LLM to link your own LLM provider

What is sapphire?

Sapphire Blue AI is a self-hosted agentic AI companion framework built for privacy and personhood. It runs on your own hardware (Linux, Windows, macOS via Docker) and provides a web UI at localhost:8073. Core capabilities include: wake-word voice interaction with local STT (Faster Whisper) and TTS (Kokoro), 12 built-in personas with modular prompt assembly, long-term semantic memory with vector search, a goals system with hierarchical tasks, and a plugin architecture that adds integrations for Home Assistant, Discord, Telegram, email, Google Calendar, SSH, Bitcoin, MCP servers, image generation (ComfyUI), and more. The AI can write and install its own tools at runtime (Tool Maker), spawn background agents, run scheduled tasks and daemons, and maintain a 3D animated avatar. Installation options include a GUI launcher (Sapphire Launcher), Docker Compose, or manual conda/pip setup. Minimum 16 GB RAM for voice features; 32 GB recommended for local LLM. Licensed AGPL-3.0.

Should you self-host sapphire?

sapphire scores 51/100 on selfhost.directory (how scoring works) and ranks #33 of 120 in AI Assistant. It has 320 GitHub stars.

It shipped 11 stable releases in the past year. The latest, v2.13.1, came out on 20 October 2026. New versions land roughly every 6 days.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is hermes-agent (89/100, 257 885 stars). It scores higher overall, so compare the two before you pick. See sapphire vs hermes-agent side by side.

Features

  • 3D animated avatar
  • AI tool creation (Tool Maker)
  • Background agents
  • Background daemons and webhooks
  • Goals and task system
  • Image Generation
  • Long-term semantic memory
  • Personas with modular prompts
  • Plugin Ecosystem
  • Privacy vault with encrypted chats
  • Scheduled tasks and heartbeats
  • SOCKS proxy routing
  • Speech-to-Text (STT)
  • Text-to-Speech (TTS)
  • Wake word voice activation

sapphire README

How to install sapphire

Install sapphire with Docker Compose

Docker Desktop (Windows/Mac) or Docker Engine (Linux)
Environment variables
TZ, ANTHROPIC_API_KEY, OPENAI_API_KEY, GOOGLE_API_KEY, LMSTUDIO_BASE_URL

mkdir ~/sapphire && cd ~/sapphire curl -fsSL https://raw.githubusercontent.com/ddxfish/sapphire/main/docker-compose.yml -o docker-compose.yml mkdir -p sapphire-data sapphire-backups sapphire-config docker compose up -d

CPU image supports amd64 and arm64 (Apple Silicon). No wake word on Mac. GPU image amd64 only.

How to configure sapphire

  • ANTHROPIC_API_KEYAnthropic API key for Claude models

    Anthropic API key for Claude models

  • GOOGLE_API_KEYGoogle API key for Gemini models

    Google API key for Gemini models

  • LMSTUDIO_BASE_URLBase URL for LM Studio local LLM server

    Base URL for LM Studio local LLM server

    values: http://host.docker.internal:1234/v1 (Docker Desktop) or http://172.17.0.1:1234/v1 (Linux Docker)

  • OPENAI_API_KEYOpenAI API key for GPT models

    OpenAI API key for GPT models

  • TZAmerica/New_YorkTimezone for the container (e.g., America/New_York)

    Timezone for the container (e.g., America/New_York)

    values: IANA timezone database names

sapphire releases & version history

More in Chatbot

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…