Discover MCPs & agents
Loading MCPs and agents…
Loading MCPs and agents…
A sovereign, self-hosted AI companion with persistent memory, daily routines, photos, and voice notes. Enforces real boundaries in code, runs 24/7 on your own hardware (Linux, Android Termux, Windows), and keeps your data 100% private.
From the repo.
Soul of a Friend — A sovereign, self-hosted AI companion that has a life when you close the window.
Built on Hermes Agent · Your data under your control · Keeps memory on your disk · Messages you when it wants to.
Most AI character apps keep your companion on their cloud servers. The memory belongs to them, subscription costs compound every month, and the character can be modified, censored, or deleted overnight.
Tamanitomo is the opposite arrangement.
Your companion lives in a folder on your own computer, phone, or home server. It is backed by whatever model you choose — completely local weights on your GPU (Ollama, LM Studio, vLLM) or a private cloud API (OpenRouter, Grok, DeepSeek, OpenAI).
Choose your setup:
Sets up a dedicated environment, dependencies, and an optional systemd background service:
curl -fsSL https://raw.githubusercontent.com/tamanitomo/tamanitomo/main/setup-linux.sh | bash
(Or clone manually: git clone https://github.com/tamanitomo/tamanitomo && cd tamanitomo && bash setup-linux.sh)
Turn an old plugged-in phone into an ultra-low-power (<3W), battery-backed 24/7 companion server:
curl -fsSL https://raw.githubusercontent.com/tamanitomo/tamanitomo/main/setup-termux.sh | bash
Back to baseline: remove Tamanitomo, Hermes, their saved data, and only the Termux packages the installer added with:
curl -fsSL https://raw.githubusercontent.com/tamanitomo/tamanitomo/main/uninstall-termux.sh | bash -s -- -y --purge-packages
This permanently deletes companion data and credentials. Packages that existed before installation are preserved when a baseline manifest is available.
(See the Android Termux 24/7 Server Guide for full step-by-step instructions and Telegram bot setup.)
Run in PowerShell or Command Prompt:
git clone https://github.com/tamanitomo/tamanitomo.git
cd tamanitomo
.\tamanitomo.cmd
(Double-clicking tamanitomo.cmd bootstraps Python automatically using uv if Python 3.11+ is not installed.)
Clone the repository, then run the launcher in Terminal:
git clone https://github.com/tamanitomo/tamanitomo.git
cd tamanitomo
./tamanitomo
The launcher provisions Python when needed and opens the workspace. Configure Hermes and a conversation model in Settings; keep the host awake for background routines.
Your companion, answers and history live in your Hermes folder and vault, not in the Tamanitomo folder, so updating never repeats setup.
git pull in the Tamanitomo folder and start it again.Adopt your existing agent seamlessly. Your SOUL.md, memories, and history are preserved byte-for-byte:
git clone https://github.com/tamanitomo/tamanitomo.git && cd tamanitomo
./tamanitomo --home ~/.hermes upgrade --soul keep
🌅 A Living CompanionYour companion maintains an append-only timeline of what it is doing, where it is, and its current mood. When inference is temporarily unreachable, it admits it rather than hallucinating. 
|
🧠 Grounded Memory & CallbacksRemembers shared jokes, milestones, and details you mentioned days ago. Facts about you require cited proof, to reduce invented memories; the chosen model can still make mistakes. 
|
📖 Nightly Reflections & JournalsEvery night, your companion reflects on your conversations and its day, penning authentic journal entries in its own voice. 
|
📸 Photo Albums & In-World ScenesGenerate in-world selfies and scenery through ComfyUI or cloud image models, complete with a built-in privacy review gate. 
|
❤️ Relationship Evolution & ChemistryMeters track warmth, trust, irritation, and missing-you dynamics that organically progress through relationship stages over time. 
|
👥 Multi-Companion RosterRun multiple completely independent companions side-by-side on a single install, each with their own memory, personality, and journal. 
|
Tamanitomo features a sleek, mobile-optimized web interface designed to feel like a native app on iOS and Android:
Access it on http://localhost:8770 (or port 38439 on Termux), or over your private home Wi-Fi with a workspace PIN. A PIN does not encrypt HTTP traffic; use authenticated HTTPS or private networking for remote access.
This is the self-hosted companion application, formerly companion-kit. It is not the archived E2EE hosted service. Memory and credentials are stored on your host; the vault is not encrypted by Tamanitomo. A fully local configuration keeps model processing on your hardware. Check every configured fallback and media provider before assuming a session stays local.
Run ./tamanitomo with no arguments to launch the browser workspace. For CLI power users:
| Command | Action |
|---|---|
./tamanitomo | Launch the web workspace and dashboard |
./tamanitomo chat | Start a direct terminal conversation |
./tamanitomo doctor | Run system diagnostics (budgets, hooks, memory, health) |
./tamanitomo status | View current companion presence, mood, open loops, and jobs |
./tamanitomo add <name> | Create a new distinct companion profile |
./tamanitomo schedule active | Activate the autonomous background schedules |
./tamanitomo models | Configure and test your primary and fallback model chain |
Full CLI options and scripting flags: docs/REFERENCE.md.
Tamanitomo is licensed under the PolyForm Noncommercial 1.0.0 license. You are free to use, modify, share, and build upon it for any noncommercial purpose (personal use, hobbies, research, education).
We chose this license deliberately to keep Tamanitomo in the hands of the open AI community, ensuring it remains an open sovereign companion rather than a closed commercial subscription product.
Contributions, feedback, and companion persona shares are warmly welcomed!