Hearthline · KI-Rezeption · Handwerk & Haustechnik
Eine KI-Rezeption für Handwerksbetriebe, von dir gehostet.
- 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
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.
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.
So funktioniert es
- 01
Ein Kunde ruft an
Vapi wandelt Sprache in Text und Text in Sprache um und schickt jeden Gesprächsschritt an Hearthline.
- 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.
- 03
Alles wird festgehalten
Leads, Anrufe, Gespräche und Angebote werden in PostgreSQL gespeichert.
- 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.
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.
Stack
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
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.
Du willst Hearthline für dein Team betreiben oder etwas Ähnliches bauen lassen?