Hearthline · KI-Rezeption · Handwerk & Haustechnik

Eine KI-Rezeption für Handwerksbetriebe, von dir gehostet.

Eine Open-Source-KI-Rezeption für Betriebe aus Klima- und Heizungstechnik, Sanitär, Dachdeckerei und Solar. Sie nimmt jeden eingehenden Anruf über Vapi an, qualifiziert den Lead, bucht einen Termin, erstellt ein Angebot aus einem Foto und legt einen strukturierten Lead im Dashboard an. Self-Hosted, mit deinen eigenen Modell- und Telefonie-Keys, verschlüsselt gespeichert.
Status
Beta
Lizenz
AGPL-3.0 · kommerzielle Lizenz verfügbar
Auf GitHub
★ 8 · ⑂ 6
eingehende Anrufe angenommen und qualifiziert
24/7
Kanäle: Telefon, SMS, WhatsApp, E-Mail, Web
5
UI-Sprachen, darunter Japanisch
10
01

Warum es das gibt

Die meisten KI-Rezeptionen sind geschlossene Dienste: eine Monatsgebühr pro Standort, eine Stimme, die der Anbieter ausgesucht hat, und Anrufdaten, die in seiner Datenbank bleiben.

Hearthline dreht diese drei Punkte um. Die Rezeption trägt deinen Namen, spricht mit deiner Stimme und folgt deinem Skript. Die KI läuft mit deinen eigenen API-Keys, du zahlst also pro Anruf den Preis des Anbieters. Leads, Anrufe und Angebote liegen in deiner eigenen PostgreSQL-Datenbank.

02

Was es kann

  • Eine Rezeption mit deinem Namen und deiner Stimme

    Leg Name, Persona, Stimme und Wissensdatenbank für den Betrieb fest. Anrufer hören zu jeder Uhrzeit deinen Betrieb am Telefon.

  • Deine eigenen KI-Keys

    Keys für Anthropic, OpenAI, Vapi und Twilio werden pro Betrieb gespeichert, im Ruhezustand verschlüsselt und im Dashboard maskiert. Den Modellanbieter wechselst du in den Einstellungen.

  • Ein Posteingang für alle Kanäle

    Anrufe, SMS, WhatsApp, E-Mail und Webchat landen pro Kunde auf einer gemeinsamen Timeline.

  • Leads, Angebote und Tickets

    Der Agent legt einen strukturierten Lead im Dashboard an und entwirft ein Angebot, das du bearbeiten und drucken kannst. Eingehende Nachrichten öffnen Support-Tickets mit Antworten im Thread.

  • Dashboard in zehn Sprachen

    Englisch, Spanisch, Deutsch, Französisch, Italienisch, Portugiesisch, Niederländisch, Chinesisch, Japanisch und Arabisch, mit Rechts-nach-links-Layout für Arabisch.

  • Neun Gewerke als Startpunkt

    Heizung und Klima, Sanitär, Fenster, Dach, Solar, energetische Sanierung, Elektro, Garagentore und Schädlingsbekämpfung, jeweils mit einer anpassbaren Wissensdatenbank.

03

So funktioniert es

  1. 01

    Ein Kunde ruft an

    Vapi wandelt Sprache in Text und Text in Sprache um und schickt jeden Gesprächsschritt an Hearthline.

  2. 02

    Der Agent entscheidet, was zu tun ist

    Ein Django-Service führt die Rezeptions-Schleife mit Claude oder OpenAI aus. Er kann den Lead qualifizieren, Verfügbarkeiten prüfen, ein Angebot entwerfen, einen Termin buchen und eine SMS oder E-Mail senden.

  3. 03

    Alles wird festgehalten

    Leads, Anrufe, Gespräche und Angebote werden in PostgreSQL gespeichert.

  4. 04

    Dein Team arbeitet im Dashboard

    Das Next.js-Dashboard zeigt Übersicht, Leads, Anrufe, Angebote, Kunden und Support-Tickets. Auf einer Testseite chattest du mit der Rezeption, ganz ohne Telefonnummer.

hearthline / live calls
incoming · +1 (555) 0192
A
Anna
AI receptionist · Apex HVAC
“Hi! This is Anna from Apex HVAC — how can I help you today?”
02:14 · transcribing
~/hearthline/leadwriting → postgres
nameSarah K.
serviceHVAC repair · no heat
address1142 Oak St · zone 3
slotThu 2:00 PM
quote$1,248 · drafted from photo
✓Lead qualified
✓Slot booked · Thu 2:00 PM
✓Photo quote drafted
5 channels · phone · sms · whatsapp · email · webbeta
04

Selbst ausführen

Der komplette Stack startet mit Docker Compose. Die Demo braucht keine API-Keys: Jeder externe Dienst fällt auf einen Stub zurück, das Dashboard funktioniert also trotzdem.

$ git clone https://github.com/codewithmuh/hearthline.git$ cd hearthline$ cp .env.example .env$ docker compose up --build$ docker compose exec backend python manage.py seed_demo --wipe$ docker compose exec backend python manage.py seed_admin
  • Dashboard: http://localhost:3000
  • Django-Admin: http://localhost:8000/admin
  • REST-API: http://localhost:8000/api
  • Mit einem Anthropic- oder OpenAI-Key wird die Testseite zu einem echten Gespräch.
05

Stack

Frontend
Next.js 15React 19TypeScript
Backend
Django 5Django REST Framework
Datenbank
PostgreSQL 16
Sprache und Messaging
VapiTwilio
KI
Claude (die Agent-Schleife)OpenAI (Vision, optionaler Anbieter)
Betrieb und Deployment
Docker ComposeVercelCaddy
06

Aktueller Stand

Fertig

  • KI- und Voice-Keys pro Betrieb, verschlüsselt mit Fernet
  • Die Agent-Schleife der Rezeption mit sieben Tools, auf Anthropic oder OpenAI
  • Dashboard: Übersicht, Leads, Anrufe, bearbeitbare und druckbare Angebote, Kunden, Einstellungen und der Test-Simulator
  • Dashboard in zehn Sprachen
  • Rate Limiting am Modell-Endpoint, signierte Webhook-Prüfungen und Start-Guards für fehlende Secrets

Noch offen

  • Stripe-Anzahlungen, wenn ein Angebot angenommen wird
  • Ausgehende SMS und WhatsApp zum Versenden von Angeboten
  • Mehrere Betriebe in einem Deployment (heute ist es ein Betrieb pro Deployment)
  • Begleit-Apps für iPhone und Android
  • Techniker-Disposition mit Routenplanung
07

Fragen

Ist Hearthline kostenlos?
Der Code ist unter AGPL-3.0 kostenlos, wenn du ihn selbst hostest. Deine Anbieter (das Modell, Vapi, Twilio) bezahlst du selbst nach Nutzung. Für White-Labeling oder Weiterverkauf gibt es eine kommerzielle Lizenz.
Kann ich es ohne API-Keys ausprobieren?
Ja. Der Stack läuft mit einem Stub für jeden externen Dienst, und auf der Testseite im Dashboard chattest du mit der Rezeption. Mit einem Key wird das Gespräch echt.
Für welche Betriebe ist es gedacht?
Für Handwerks- und Haustechnikbetriebe: Heizung und Klima, Sanitär, Fenster, Dach, Solar, energetische Sanierung, Elektro, Garagentore und Schädlingsbekämpfung.
Wo werden die Daten gespeichert?
In deiner eigenen PostgreSQL-Datenbank, auf deinem Laptop oder deinem Server. Anbieter-Keys werden im Ruhezustand verschlüsselt.
Ist es bereit für die Produktion?
Es ist in der Beta. Ein Deployment bedient heute einen Betrieb, und Anzahlungen, ausgehende Nachrichten und die Mobile-Apps sind noch in Arbeit.
→Zusammenarbeiten

Du willst Hearthline für dein Team betreiben oder etwas Ähnliches bauen lassen?