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.

GitHub
who-rang logo

Self-host who-rang

v1.0.0

AI doorbell with face recognition and multi-provider AI

ReleaseOpen SourceMIT
Updatedlast year
LanguageTypescript
Setup difficultyModerate
MobileResponsive
Stars
227
RAM
2GB
Storage
5GB
Ports
80 (Frontend (nginx)), 3001 (Backend API and WebSocket)
Requires
SQLite
Install with Docker Compose
Main dashboard showing real-time visitor monitoring with AI-powered insightsAI provider configuration screen with 5 provider optionsAI analytics dashboard tracking costs, performance, and usage across providersFace recognition settings for visitor identification

What is who-rang?

WhoRang turns a doorbell camera into a smart visitor identification system. It accepts webhook events from Home Assistant or other sources, analyzes visitor images using one of five AI providers (OpenAI Vision, Anthropic Claude, Google Gemini, Google Cloud Vision, or local Ollama), and performs face recognition to track repeat visitors. The mobile-first dashboard delivers real-time updates via WebSockets. The stack runs via Docker Compose with a React/TypeScript frontend on port 8080 and a Node.js/Express backend on port 3001, using SQLite for storage. Features include comprehensive analytics with CSV/PDF export, AI cost tracking across providers, weather correlation, and a privacy-first design that works fully offline with local AI. The project is MIT licensed and actively maintained.

who-rang alternatives

Should you self-host who-rang?

who-rang scores 47/100 on selfhost.directory (how scoring works) and ranks #78 of 104 in Home Automation. It has 227 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Home Assistant (91/100, 91 851 stars). It scores higher overall, so compare the two before you pick. See who-rang vs Home Assistant side by side.

Features

  • AI cost tracking
  • CSV/PDF export
  • Face Recognition
  • Multi-provider AI analysis
  • Privacy-first local processing
  • Real-time dashboard
  • Visitor analytics
  • Weather correlation

who-rang README

🔔 WhoRang - AI-Powered Doorbell Intelligence

Transform your doorbell into an intelligent visitor identification system with advanced face recognition, multi-provider AI analysis, and comprehensive visitor insights.

Docker AI Powered Mobile First Self Hosted


📸 Screenshots

Click any screenshot to view full size

🏠 Main Dashboard
Real-time visitor monitoring with AI-powered insights

WhoRang Dashboard
🤖 AI Provider Configuration
Choose from 5 different AI providers for optimal performance

AI Providers Setup
📊 AI Analytics & Insights
Track costs, performance, and usage across all AI providers

AI Analytics Dashboard
👤 Face Recognition Settings
Advanced face detection and visitor identification

Face Recognition Settings

How to install who-rang

Install who-rang with Docker Compose

Environment variables
VITE_API_URL, VITE_WS_URL, CORS_ORIGIN, WEBHOOK_TOKEN, WEBHOOK_PATH, TRUST_PROXY, DATABASE_PATH, NODE_ENV, PORT, PUBLIC_URL, FRONTEND_DOMAIN, FRONTEND_PORT, BACKEND_DOMAIN, BACKEND_PORT, CORS_MODE, DOCKER_ENV

git clone https://github.com/Beast12/who-rang.git cd who-rang docker-compose up -d --build

Access your dashboard

open http://localhost:8080

Production deployment with nginx frontend and Node.js backend

How to configure who-rang

  • PUBLIC_URLhttps://yourdomain.comThe base URL for your frontend application
  • FRONTEND_DOMAINyourdomain.comFrontend domain
  • FRONTEND_PORT8080Frontend port
  • BACKEND_DOMAINapi.yourdomain.comBackend domain
  • BACKEND_PORT3001Backend port

who-rang releases & version history

More in Home Automation

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…