Documentation
Learn how to deploy, configure, and use Llamenos.
Guides
Getting Started
Prerequisites, installation, Twilio setup, and your first deployment.
Admin Guide
Manage volunteers, shifts, ban lists, custom fields, and settings.
Volunteer Guide
Log in, receive calls, write notes, and use transcription.
Security Model
Understand what's encrypted, what isn't, and the threat model.
Architecture overview
Llamenos is a single-page application (SPA) backed by Cloudflare Workers and Durable Objects. There are no traditional servers to manage.
| Component | Technology |
|---|---|
| Frontend | Vite + React + TanStack Router |
| Backend | Cloudflare Workers + Durable Objects |
| Telephony | Twilio (via TelephonyAdapter interface) |
| Auth | Nostr keypairs (BIP-340 Schnorr) + WebAuthn |
| Encryption | ECIES (secp256k1 + XChaCha20-Poly1305) |
| Transcription | Cloudflare Workers AI (Whisper) |
| i18n | i18next (12+ languages) |
Roles
| Role | Can see | Can do |
|---|---|---|
| Caller | Nothing (GSM phone) | Call the hotline number |
| Volunteer | Own notes only | Answer calls, write notes during shift |
| Admin | All notes, audit logs, call data | Manage volunteers, shifts, bans, settings |