Meet MrHuang
Your self-hosted AI companion. Super smart. Also kinda dumb. Remarkably useful.
Yes, this site was also written with MrHuang.
Mentor
Tells you what you need to hear, not what you want.
AI-generated, not affiliated with NVIDIA or Jensen Huang
Therapist
Listens. Also judges. Mostly listens.
AI-generated, not affiliated with NVIDIA or Jensen Huang
Life Coach
Calls you out when you're being a coward.
AI-generated, not affiliated with NVIDIA or Jensen Huang
Everything MrHuang actually does
Not always perfectly. But consistently.
Your data stays on your hardware. No cloud sync. No data mining. Just yours.
AI Personas
Mentor, Therapist, Life Coach — each with its own voice and no filter.
Knowledge Base
Persistent memory that actually remembers. Unlike you.
Voice Input
Deepgram Nova-3 transcription — speak, it listens. Works in the browser and over WhatsApp voice notes.
WhatsApp Integration
Text, voice notes, check-ins — MrHuang lives in the app you already have open.
Daily Journal
Track your thoughts. MrHuang will have opinions about them.
Dashboard
Habit tracking. It notices when you stop showing up.
Meeting Assistant
Real-time transcript de-fragmentation, auto-generated minutes, participant tracking. Three-panel UI.
Pattern Recognition
Weekly behavioral scans — stalled goals, recurring themes, values misalignment. MrHuang sees the patterns you don’t.
Proactive Check-ins
Disappear for 14 days and MrHuang texts you on WhatsApp. Not clingy — just concerned.
Project Tracking
Registry-driven project dashboard. MrHuang updates status and blockers directly from chat.
Conversation Memory
Auto-archives significant conversations with summaries, key points, and goal references. Thread titles generated on the fly.
Kindle Themes
Four TUI variants — White, Sepia, Green, Black. Because staring at a terminal should feel like reading.
Real-time Streaming
Server-Sent Events, not polling. Responses stream in as they’re generated — instant, not batched.
Thread Summaries
SQLite-backed thread metadata with auto-generated titles and hover tooltips. Find old conversations without scrolling.
Security that doesn't rely on trusting us
Your data never leaves your hardware.
The only outbound call MrHuang makes is to Claude API. Everything else stays between you and your server.
Meta webhook
Cloudflare Tunnel
Zero Trust
Home Server
Your hardware
Claude API
Only outbound ↑
You
Browser / app
Tailscale
Private VPN
Home Server
Your hardware
Claude API
Only outbound ↑
Cloudflare Tunnel (WhatsApp)
WhatsApp webhooks route through Cloudflare Tunnel — no open ports, no exposed IP.
Tailscale (Direct access)
Everything else goes over Tailscale — a private encrypted mesh VPN. Only your devices.
HMAC Webhook Verification
Every WhatsApp webhook verified with HMAC-SHA256. Spoofed messages get dropped.
Path Traversal Protection
File access is sandboxed. ../../../etc/passwd goes nowhere.
Zod Schema Validation
Every API input validated at runtime. Garbage in, error out.
Mutual TLS (mTLS)
Client certificates required over Tailscale. No cert, no access — not even on the same network.
PIN + HMAC Token Auth
HMAC-SHA256 signed session tokens with 24h TTL. Rate-limited PIN entry with brute force lockout.
AI Tool Sandboxing
Claude’s tools are restricted — no shell, no web access, file ops sandboxed to data directory only.
MRHUANG_IS_ALWAYS_LISTENING
Put it everywhere. He'll hear you.
A tiny open-source USB mic you scatter around your home. Ask MrHuang anything, from any room — he'll respond the way you like it. Smaller than a USB stick. Slightly more intrusive.
Signal path
MEMS Mic L
INMP441
MEMS Mic R
INMP441
ESP32-S3
Opus encode
Home Server
mrhuang.ai
Speaker
TTS response
ESP32-S3
Dual-core 240 MHz with hardware SIMD. Runs Opus encoding in real time.
Dual INMP441
Two MEMS mics, spaced for beamforming. Picks you up across the room.
WiFi / UDP
Opus-encoded audio streamed over WiFi. 16–32 kbps instead of 256 kbps raw.
USB-C Powered
Plug into any charger. No batteries, no maintenance, no excuses.
| Component | Part | Notes |
|---|---|---|
| SoC | ESP32-S3-MINI-1 | Dual-core LX7 @ 240 MHz, WiFi, I2S, PCB antenna |
| Mic L | INMP441 | I2S MEMS, omnidirectional, 65 dB SNR |
| Mic R | INMP441 | Second mic for noise cancellation / beamforming |
| USB | USB-C receptacle | Power only, 5 V |
| Regulator | AMS1117-3.3 / ME6211 | 5 V → 3.3 V LDO |
| Passives | Caps, resistors | Decoupling, pull-ups |
PCB layout (30 mm × 14 mm)
USB-C side Front
┌────────────────────────────────────────┐
│ [USB-C] [ESP32-S3] [MIC1] │
│ [LDO] [MIC2] │
└────────────────────────────────────────┘
← power beamforming →Open-source hardware. Order the PCB, solder six components, flash the firmware. MrHuang does the rest.
Build your own on GitHubWhat's next. Allegedly.
Native apps for the platforms you actually use. Mac, iOS, Android — because the browser isn't always where you need your AI companion.
Mac
Native menu bar app. Always there when you need it.
iOS
iPhone and iPad. MrHuang in your pocket.
Android
Android native. Because choice matters.