Documentation
Learn how to deploy, configure, and use Llamenos.
Getting Started
Deploy your own Llamenos hotline
User Guides
How-to guides by role and task
Provider Setup
Connect your voice and messaging providers
Provider Comparison
Compare all supported telephony providers
Twilio
Configure Twilio voice and SMS
SignalWire
Configure SignalWire
Vonage
Configure Vonage
Plivo
Configure Plivo
Asterisk
Self-hosted with ARI bridge
SMS
Enable inbound/outbound SMS
Connect WhatsApp Business
Signal
Set up the Signal channel
WebRTC
In-browser call answering
Reference
Technical documentation and troubleshooting
Architecture overview
Llamenos is a single-page application (SPA) that can run on Cloudflare Workers or on your own infrastructure via Docker Compose / Kubernetes. It supports voice calls, SMS, WhatsApp, and Signal — all routed to on-shift volunteers through a unified interface.
| Component | Cloudflare | Self-Hosted |
|---|---|---|
| Frontend | Vite + React + TanStack Router | Same |
| Backend | Cloudflare Workers + 6 Durable Objects | Node.js + PostgreSQL |
| Blob Storage | R2 | RustFS (S3-compatible) |
| Voice | Twilio, SignalWire, Vonage, Plivo, or Asterisk | Same |
| Messaging | SMS, WhatsApp Business, Signal | Same |
| Auth | Nostr keypairs (BIP-340 Schnorr) + WebAuthn | Same |
| Encryption | ECIES (secp256k1 + XChaCha20-Poly1305) | Same |
| Transcription | Client-side Whisper (WASM) | Client-side Whisper (WASM) |
| i18n | i18next (13 languages) | Same |
Roles
| Role | Can see | Can do |
|---|---|---|
| Caller | Nothing (phone/SMS/WhatsApp/Signal) | Call or message the hotline |
| Volunteer | Own notes, assigned conversations | Answer calls, write notes, respond to messages |
| Reporter | Own reports only | Submit encrypted reports with file attachments |
| Admin | All notes, reports, conversations, audit logs | Manage volunteers, shifts, channels, bans, settings |