Use Cases

Built for the way
you actually work

humux adapts to different workflows. Here are four common patterns — find yours.

Persona 1

The Solo Developer

Your AI pair programmer, researcher, and release manager

You're a developer who wants an AI that works with your codebase, not in a separate chat window. humux's coding harness lets the agent read, write, and edit files in a confined workspace. It can grep, refactor, run commands, and commit changes — all through Telegram, the CLI channel, or the admin UI.

"Review the PR in /workspace and summarize the changes"
"Read the error log and suggest a fix"
"Run tests, check the results, and open an issue if any fail"
Coding harness Browser automation Web search GitHub integration
Telegram — humux
You: can you review the commit in workspace/pr-137?
humux: Looking at the diff in pr-137...
Found 3 files changed. The auth middleware has a token expiry check that uses < instead of <= — off-by-one, tokens still valid for 1 second after expiry get rejected.
Suggested fix: expires_at <= now()
You: good catch. apply it.
✔ Fix applied. Commit a1b2c3d ready to push.
bash — vault check
docker ps
CONTAINER ID IMAGE STATUS
abc12345 ghcr.io/mattmezza/humux:latest Up 3 days
# No cloud. No telemetry. No third-party AI.
# Your keys. Your data. Your rules.
Persona 2

The Privacy Advocate

Full data sovereignty. Zero cloud dependencies.

Your AI should not send your emails, contacts, or calendar data to a third party. humux runs everything locally in a single Docker container on your own hardware. API keys are sealed in an encrypted vault — never exposed to the LLM context. Memory stays in your SQLite database. No telemetry, no phoning home.

Offline-capable voice (Kokoro 82M) — no cloud TTS needed
Encrypted two-tier vault with Bitwarden import
Credentials resolve from vault — never enter model context
Self-contained: SQLite, no external databases, no sidecars
Vault encryption Offline voice Local storage No telemetry
Persona 3

The Power User

Email triage, calendar management, task automation

Your inbox is overflowing, your calendar is fragmented across Google and iCloud, and you have recurring tasks that eat your time. humux reads and manages email (per-agent mailboxes), checks and creates calendar events, searches contacts, and runs scheduled tasks — all through Telegram, the CLI channel, or the admin UI.

"Summarize my unread emails and flag anything urgent"
"Schedule a 30min meeting with Alex next Tuesday at 2pm"
"Send a morning briefing daily at 7am with weather, schedule, and top emails"
"Find John's phone number in contacts and send him a WhatsApp message"
Email triage Calendar Scheduled jobs Contacts
Telegram — humux
You: morning briefing
humux: Good morning! Here's your briefing for Thursday, July 2:
☀️ Weather: 22°C, partly cloudy
📧 14 unread — 2 from your boss, 1 newsletter
📅 3 events today: Standup 10am, Dentist 2pm, Review 4pm
🔔 Reminder: PR review due tomorrow
Telegram — Team Chat
Alice: @support-bot can you check the deploy status?
support-bot: Deploy #847 completed successfully at 14:32 UTC. All health checks pass.
Bob: @research-bot what's the latest on the auth rewrite?
research-bot: I found 3 recent articles on OAuth 2.1 migration. PR #312 in review. Want me to summarize?
— Multiple agent-bots in one group. Each responds only when addressed. No loops. —
Persona 4

The Team Assistant

Multiple agents, one Telegram group, zero collisions

Your team needs different AI personalities for different domains — a support agent, a research agent, a devops agent. humux's per-agent bots let you drop multiple agents into one Telegram group. Each has its own context, tools, and identity. They only reply when addressed and ignore other bots — no infinite loops, no confused replies.

Each agent has its own Telegram bot token and isolated context
Bots tag who said what in shared history — full audit trail
Per-chat permissions: control who can DM each agent in each group
Background subagents handle long tasks — monitor via /jobs
Multi-agent Group chat Subagents Job monitoring

Which persona fits you?

humux works for all of them. One container, your configuration.