Renfield Bat Logo

RENFIELD

Self-hosted AI assistant with voice satellites, 100+ tool integrations, and full offline capability.

Voice Satellites 100+ Tools Fully Offline Open Source

Features

Everything you need for a private, self-hosted AI assistant.

πŸŽ™οΈ

Voice Satellites

Pi Zero 2 W with wake word detection, STT & TTS. One per room, starting at ~30 EUR.

πŸ•ΈοΈ

Knowledge Graph

Entities & relations extracted from conversations and documents via LLM, stored with vector embeddings.

πŸ”

RAG Hybrid Search

Dense + BM25 via Reciprocal Rank Fusion. Ingest PDF, DOCX, XLSX, and more.

πŸ“

Presence Detection

BLE scanning, speaker recognition, and web-auth presence. Room-level tracking with privacy-aware TTS.

πŸ€–

Agent Loop (100+ Tools)

ReAct agent with 9 MCP servers: Home Assistant, n8n, weather, search, news, calendar, and more.

🧠

Long-Term Memory

Learns preferences and facts over time with contradiction detection and semantic recall.

🏠

Smart Home

Control Home Assistant devices with natural language. Dynamic keyword matching for accurate intent.

πŸ”’

Offline & Private

Your hardware, your data. No cloud dependency. GDPR-compliant by design.

Screenshots

A clean, responsive interface with full dark mode support.

Chat - Light Mode

Architecture

Modular design with MCP protocol for tool integration, local LLM inference via Ollama, and a React PWA frontend.

Renfield Architecture Diagram
User Input Intent Recognition Agent / Action MCP Tools Response

Quick Start

Up and running in three steps. No cloud account required.

1

Clone & configure

git clone https://github.com/ebongard/renfield.git
cd renfield
cp .env.example .env    # edit to your needs
2

Start the stack

docker compose up -d
3

Pull a model

docker exec -it renfield-ollama ollama pull qwen3:8b

Open http://localhost:3000 and start chatting.

Tech Stack

Built on proven open-source technologies.

Ollama FastAPI React PostgreSQL pgvector Redis Docker Home Assistant Tailwind CSS Whisper Piper TTS SpeechBrain n8n SearXNG Paperless MCP Protocol