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.

mirrormate logo

Self-host mirrormate

v0.1.13

Voice-first AI companion that lives in a mirror

AlphaOpen SourceMIT
Updated9 months ago
LanguageTypescript
Setup difficultyAdvanced
Stars
495
Port
3000 (Next.js web UI)
Docker
ghcr.io/orangekame3/mirrormate
Install with Docker
mirrormate screenshot 1

What is mirrormate?

MirrorMate places a conversational AI behind a two-way mirror driven by a Raspberry Pi. The wake phrase "Hey Mira" starts a hands-free dialogue. You can pick from several model backends — OpenAI or a local Ollama instance — several voice engines — OpenAI TTS or VOICEVOX — and several transcription options — the browser's built-in API, OpenAI's hosted Whisper, or a local Whisper build. A retrieval-augmented store remembers personal details from earlier chats and weaves them into new answers. An on-screen face rendered with Three.js cycles through eight expressive states and lip-syncs to the audio. Ready-made links pull weather from Open-Meteo, events from Google Calendar, search results from Tavily, and can post to Discord. A plug-in layer allows extra widgets or sensors such as a vision module that notices when you look at the mirror. The codebase uses Next.js 15, React 19, Node.js, SQLite via Drizzle, and Docker. A fully local deployment offloads the heavy models to a separate GPU box connected over Tailscale, while a cloud-backed mode needs only the Pi. The project is still early and has rough edges.

Should you self-host mirrormate?

mirrormate scores 43/100 on selfhost.directory (how scoring works) and ranks #8 of 11 in Voice Assistants. It has 495 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v0.1.13, came out on 6 January 2026.

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

Its closest alternative on selfhost.directory is dograh (70/100, 5 972 stars). It scores higher overall, so compare the two before you pick. See mirrormate vs dograh side by side.

Features

  • Calendar Integration
  • Discord Sharing
  • Expressive avatar with lip-sync
  • Fully local inference
  • Multi-Provider LLM Support
  • Multi-provider STT support
  • Multi-provider TTS support
  • Personalized memory (RAG)
  • Plugin System
  • Reminders
  • Voice-first interaction
  • Wake word activation
  • Weather Integration
  • Web search integration

mirrormate README

How to install mirrormate

Install mirrormate with Docker

Environment variables
OPENAI_API_KEY, LLM_PROVIDER, TTS_PROVIDER

docker run -p 3000:3000
-e OPENAI_API_KEY=sk-xxx
-e LLM_PROVIDER=openai
-e TTS_PROVIDER=openai
ghcr.io/orangekame3/mirrormate:latest

Easiest setup using OpenAI API

mirrormate releases & version history

More in Voice Assistants

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…