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, sets reminders, tracks todos. "Hey Hank, remind me about the meeting at 3" — done. Keeps your day organized without you touching a calendar app.
Voice calls via SIP/FreeSWITCH integration. Hank can make and receive phone calls on your behalf — schedule calls, take messages, handle routine conversations.
Coming SoonDraft, schedule, and publish posts across platforms. Integrates with Postiz, Buffer, and Ayrshare. Content calendar with analytics. Let Hank manage your social presence.
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.
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? Create custom agents — Hank's employees — each trained for a specific role. They work autonomously, report back to Hank, and can even hire their own sub-agents when the job demands it. It's a full company org chart of AI workers. You're the CEO, Hank is your department lead, and his agents are the team that gets the work done.
Your AI Company
You give Hank the job. He delegates to the right employee. They do the work and report back. Need a new role? Create an agent — Hank onboards them instantly.
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, Buffer, or Ayrshare 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.