# Companion Space

> Self-hosted, open-source anime-style AI companion for learning with VRM 3D avatars, RAG-based document Q&A, and real-time voice chat.

- **Category:** AI Assistant
- **Licence:** Apache-2.0
- **Open source:** oss
- **Languages:** Typescript, Python
- **Platforms:** Docker Compose
- **Tags:** Local First, Rag, Anime, Voice Chat, Next.js, Fastapi, Self Hosted, Voice ai, Ai companion, Vrm, Study Assistant

## Description

Companion Space is a local-first anime companion and study application that lets users create independent learning spaces, import their own materials, and interact with virtual characters via text or real-time voice. It features VRM 3D avatars with lip-sync, expressions, and gaze tracking, retrieval-augmented generation with answer citations, and replaceable AI providers including OpenAI-compatible APIs, Ollama, and a built-in Mock for offline testing. An optional neural TTS sidecar (Qwen3-TTS) runs on NVIDIA GPU. The stack runs via Docker Compose with Caddy providing local HTTPS, a Next.js frontend, and a FastAPI backend. All data stays on the user's machine by default; provider credentials are stored in an encrypted server-side vault. Mobile access is available through opt-in Capacitor Android/iOS wrappers that pair with a trusted HTTPS origin.

## Links

- [Homepage](https://github.com/johnson-durui/companion-space)
- [GitHub Repository](https://github.com/Johnson-Durui/Companion-Space)
- [Deployment Documentation](https://github.com/Johnson-Durui/Companion-Space/blob/main/docs/deployment.md)
- [Architecture Documentation](https://github.com/Johnson-Durui/Companion-Space/blob/main/docs/architecture.md)
- [Mobile Pairing Guide](https://github.com/Johnson-Durui/Companion-Space/blob/main/docs/lan-pairing.md)
- [Privacy & Data Handling](https://github.com/Johnson-Durui/Companion-Space/blob/main/docs/privacy-and-data.md)
- [Security Model](https://github.com/Johnson-Durui/Companion-Space/blob/main/docs/security-model.md)
- [Asset Licensing](https://github.com/Johnson-Durui/Companion-Space/blob/main/docs/asset-licensing.md)

---
Source: https://selfhost.directory/project/companion-space