He sits right next to you in the office. Manages your emails, handles your calendar, posts on social media, writes code, creates presentations, makes phone calls. And when the workload grows, he hires his own team — specialized AI agents that work for him like employees in a department.
Self-hosted. Private by default. Runs on your machine. Your data stays yours.
$ bunx heyhank
Requires Bun v1.0+ · Then open localhost:3456
What Hank Does
Hank isn't a chatbot. He's your colleague — the kind who handles everything you throw at him. When a task is too big or too specialized, he doesn't struggle alone. He hires an employee: a dedicated AI agent built for exactly that job.
Multi-account IMAP/SMTP email with full inbox management. Read, compose, reply, search — from the UI or by talking to Hank. Supports Gmail, Outlook, iCloud, Yahoo, and any custom provider.
Manages your schedule via CalDAV, sets reminders with calendar alerts, tracks todos and projects. Delegation tracking with follow-up reminders. Daily briefing with your agenda, emails, and tasks at a glance.
Voice calls via SIP/FreeSWITCH integration. Hank can make and receive phone calls on your behalf — schedule calls, take messages, handle routine conversations.
Draft, schedule, and publish posts across platforms. Integrates with Postiz and Buffer. Built-in Content Engine analyzes your website and generates platform-optimized content with proven copywriting frameworks. Content calendar with analytics.
Multi-session Claude Code and Codex agent management. Run multiple coding sessions simultaneously with streaming, tool call visibility, and permission control. 40+ AI providers.
Creates slide decks and documents on demand. Tell Hank what you need, he builds it. Export-ready for your next meeting.
Generate images with Imagen 4 and videos with Veo 3.1 — directly from the UI or via voice. Need a thumbnail, a social media graphic, or a product video? Just ask.
Full contact management with company, email, phone, and interaction history. Log every call, email, and meeting. "When did I last talk to Müller?" — Hank knows.
Analyzes your website, identifies your business type and audience, then generates a full content strategy with platform-optimized posts. Uses proven copywriting frameworks (PAS, AIDA, StoryBrand) mapped to the customer journey. Ad creatives included.
Semantic memory with RAG — Hank remembers your preferences, decisions, and context. Import your history from ChatGPT, Claude, or Gemini to give Hank a head start. Syncs bidirectionally with Obsidian as your second brain. Decision log tracks the "why" behind every choice.
Store contracts, proposals, and files. Create reusable templates with {{variable}} placeholders for emails, invoices, and meeting agendas. Hank fills them out with context from your contacts and projects.
Start/stop timers, log time manually, get reports by project, category, or day. "What did I work on this week?" — Hank generates a breakdown with total hours per project.
Create invoices, track expenses, see revenue and profit at a glance. Auto-numbered invoices with tax calculation. "How much revenue this quarter?" — Hank runs the numbers.
Define business metrics, record values, track trends. Traffic, revenue, customer count — all in one place with targets, thresholds, and historical charts. "How are my KPIs?" — instant status.
Monitor competitors, industry news, and keywords via RSS feeds or web crawling. Hank checks your sources, summarizes what's new, and flags what matters. "What's new in my industry?"
For complex tasks, Hank spins up a Team Coordinator — a project manager agent that analyzes the goal, hires specialized agents on the fly, gives each one an isolated workspace (git worktree), monitors progress, resolves conflicts, and merges the results. Agents that don't exist yet get created automatically.
Talk to Hank hands-free via Gemini Live. He listens, understands context, executes tools, and speaks back. Like having a real conversation with your coworker.
Need a research analyst? A content writer? A data wrangler? A customer support rep? You don't have to create them yourself — the Team Coordinator hires them automatically when a task requires a specialist that doesn't exist yet. Each agent is trained for a specific role, works autonomously, and reports back. Your AI company grows organically with every project. You're the CEO, Hank is your department lead, and the team builds itself.
Your AI Company
You give Hank the job. For simple tasks, he delegates to the right employee. For complex multi-part projects, he activates the Team Coordinator — a project manager who analyzes the goal, hires the right specialists (creating new agents if none exist), assigns them to isolated workspaces, and merges everything together.
Hank — Department LeadYour Machine, Your Rules
HeyHank runs entirely on your hardware. No cloud dependency, no data leaving your machine. Full control over what Hank can access.
Mac, Windows, or Linux. One command to install, no Docker or databases required.
Read and write files, run shell commands, execute scripts. Full access or sandboxed — your choice.
Browse the web, fill forms, extract data from any site. Hank can navigate the web like you do.
Coming SoonAI Providers
40+ AI providers out of the box. Cloud APIs, gateway services, or local models — pick what works for you.
Quick Start
Just want to see what Hank can do? This gets you a running instance with Claude Code in under a minute.
# 1. Install Bun (if you don't have it) curl -fsSL https://bun.sh/install | bash # 2. Install Claude Code CLI (if you don't have it) npm install -g @anthropic-ai/claude-code # 3. Start HeyHank bunx heyhank # Open http://localhost:3456 in your browser
That's it for a basic setup. Read on for the full guide — remote access, voice, email, and more.
Full Setup Guide
Everything you need, step by step. Whether you're on a MacBook or a VPS.
Required. JavaScript runtime that powers HeyHank.
curl -fsSL https://bun.sh/install | bash
Claude Code and/or Codex CLI for coding sessions.
npm i -g @anthropic-ai/claude-code
npm i -g @openai/codex
Supported OS: macOS, Linux, Windows (WSL). Works on local machines (MacBook, desktop) and remote servers (VPS, cloud instances).
bunx heyhank
Runs directly without global install. Great for trying it out.
bun install -g heyhank
heyhank install && heyhank start
Registers as a service (launchd on macOS, systemd on Linux). Starts on boot.
Open http://localhost:3456 in your browser. An auth token is generated automatically on first start — stored at ~/.heyhank/auth.json.
HeyHank needs access to AI models. How you authenticate depends on the CLI you use:
Run claude once in your terminal to log in via OAuth (opens browser). Or set the ANTHROPIC_API_KEY environment variable.
Supports 40+ providers via --provider flag — configure API keys in HeyHank's provider settings.
Run codex once in your terminal to authenticate via OpenAI OAuth. Or set OPENAI_API_KEY.
Requires a Google AI API key. Get one at aistudio.google.com/apikey and add it in HeyHank's settings. This powers the hands-free voice interface.
By default, HeyHank binds to localhost. To access it from your phone or another device:
Access via your machine's local IP, e.g. 192.168.1.x:3456. Same WiFi only.
Public HTTPS URL without port forwarding. HeyHank has built-in Tailscale Funnel support. No own domain needed.
Install on a VPS, point your domain to it, set up a reverse proxy (nginx/Caddy) with SSL. Access from anywhere.
The more you connect, the more Hank can do for you. All credentials are stored locally at ~/.heyhank/ with restricted permissions.
Add IMAP/SMTP accounts in the UI. Pre-configured for Gmail, Outlook, iCloud, Yahoo — or enter custom server details. Hank reads, composes, and replies to emails for you.
Built-in todo lists, notes, and time-based reminders. Managed via the UI or by voice through Gemini Live.
Connect Postiz or Buffer for multi-platform posting. Draft content, schedule posts, track analytics — all from one dashboard.
Add a Google AI key (same as for voice) to enable Imagen 4 image generation and Veo 3.1 video generation.
SIP integration via FreeSWITCH. Connect a SIP trunk (e.g. peoplefone, Twilio) and Hank can make and receive phone calls.
Connect multiple HeyHank instances across machines. Run agents on your local MacBook and your VPS simultaneously — Hank coordinates both.
Create your first session, pick a provider, and start working. You can also ask Hank to set things up for you — just open a Claude Code session and say "Set up my email accounts" or "Configure social media posting". He'll walk you through it.
CLI
Install HeyHank as a background service with launchd (macOS) or systemd (Linux). Starts on boot, logs to disk.
Open source. Self-hosted. MIT licensed. No subscription, no cloud lock-in. One employee who scales to an entire department.