humux triages your email, manages your calendar, sends morning briefings, handles your messages — and runs as a single Docker container on your own hardware. No cloud AI, no third-party data access.
humux doesn't just answer questions — it reads your email, checks your calendar, sends messages on your behalf, and runs scheduled tasks. All via Telegram, WhatsApp, or CLI.
Reads your email via IMAP, surfaces only what matters, drafts replies. Per-agent mailboxes with vault-secured credentials — API keys never enter the model context.
Scheduled tasks run on cron. Weather, unread emails, today's calendar, reminders — delivered as text and voice message. Configure what you care about and when.
CalDAV integration with Google Calendar, iCloud, Fastmail. The agent checks your availability, creates the event, and can email the other person — all from a single message.
Share photos or data via Telegram or email. Your agent creates shareable mini web apps —
games, collages, dashboards — hosted under /artifacts/
with a link you can send to anyone.
A personal assistant is just the start. Create specialized agents — a lead who coordinates, a developer who ships PRs, a marketing specialist, a QA — each with their own skills, tools, model, voice, and identity.
They coordinate via GitHub issues, each appearing as their own GitHub App with a distinct name and avatar. Work is dispatched, reviewed, and shipped without you in the loop — unless a task is labeled for a human.
Each agent has its own Telegram bot, GitHub App identity, and LLM configuration.
Python orchestrator + battle-tested CLI tools. Himalaya (Rust) for email, CalDAV for calendars, Playwright for browsing, faster-whisper or Kokoro for voice. SQLite for storage. No external databases, no Kubernetes.
Email, calendar, contacts, voice — integrated at the core, not via third-party plugins. Teach new capabilities by writing markdown files.
Telegram (per-agent bots, voice, reactions, inline approvals), WhatsApp, CLI
Create agents with distinct skills, tools, voice, model, and account bindings
Four-tier: lexical, semantic, importance-based forgetting, deduplication
Teach new capabilities by writing files — no code, no plugin registry
STT + TTS, local or remote. Voice messages in Telegram, voice briefings
Webhook-driven agent turns on issues, PRs, and comments. Per-agent GitHub App identity
Headless Playwright, Tavily or self-hosted SearXNG. Deep research with cited reports. Web artifacts
PWA-installable. Setup wizard, agent editor, token dashboard, log streams, memory inspector
A personal account of migrating from cloud AI assistants to humux — what worked, what broke, and what I'd do differently. The post that started it all.
Read the full storyMay 5, 2026
Four tiers of memory: lexical retrieval, semantic search, importance-based forgetting, and hygiene via deduplication.
April 21, 2026
Why describing CLI tools in markdown files beats writing Python adapter classes.
April 2, 2026
Architecture decisions that make it possible to run LLM orchestration, voice, email, and admin UI in one Docker container.
MIT licensed. Every line of code is on GitHub. No telemetry, no usage tracking, no cloud callbacks.