humux runs a squad of agents — a lead, a developer, a researcher, a marketer, a QA — that pick up your most ambitious ideas, do the work, and report back. One Docker container, on your hardware, under your own keys.
Most ideas die because one person cannot be five people. A squad fixes that. Create specialized agents — a lead who coordinates, a developer who ships PRs, a researcher who reads everything, a marketer, a QA — each with their own skills, tools, model, voice, memory and identity.
They coordinate through GitHub issues, each appearing as their own GitHub App with a distinct name and avatar. Work is dispatched, executed, reviewed and shipped without you in the loop — unless a task is labeled for a human. You stay the one with taste and the final word.
Every agent gets its own Telegram bot, GitHub App identity and LLM configuration.
Turns a one-line ambition into a milestone, issues and owners. Escalates only what needs you.
Deep research over the live web, with sources cited and a report you can actually check.
Reads, writes, edits and runs code in a confined workspace. Opens PRs under its own identity.
Positioning, launch copy, landing pages, images — published as hosted artifacts.
Reviews PRs, runs the tests, files what's broken before your users find it.
The squad is the headline. The foundation is an assistant that already runs your day: it reads your email, checks your calendar, sends messages on your behalf and runs scheduled work — from Telegram, WhatsApp or the CLI.
Reads your email over IMAP, surfaces only what matters, drafts the replies. Per-agent mailboxes with vault-secured credentials — keys never enter the model context.
Scheduled work runs on cron. Weather, unread mail, today's calendar, reminders, whatever your squad shipped overnight — delivered as text and as voice.
CalDAV against Google Calendar, iCloud or Fastmail. Checks availability, creates the event and emails the other person — from a single message.
Send photos or data over Telegram or email. Your agent builds shareable mini web apps
— games, collages, dashboards — hosted under /artifacts/
with a link you can pass to anyone.
A Python orchestrator plus 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. No account to sign up for.
Email, calendar, contacts, voice, code, search — integrated at the core, not through third-party plugins. New capabilities are taught by writing a markdown file.
Telegram (per-agent bots, voice, reactions, inline approvals), WhatsApp, CLI. Live web transcripts
Agents with distinct skills, tools, voice, model and account bindings. Fan out subtasks to several at once
Four tiers: 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, prompt inspector, log streams, memory inspector
A personal account of moving off hosted assistants and onto humux — what worked, what broke, and what I'd do differently. The post that started all of this.
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 orchestration, voice, email and the admin UI in one Docker container.
MIT licensed. Every line of code is on GitHub. No telemetry, no usage tracking, no cloud callbacks. Your squad answers to you and nobody else.