Skip to main content
Headmaster is a free, open-source desktop workspace where AI specialists handle real work on your computer: reading and writing files, running code, browsing the web, generating documents, and running automated tasks on a schedule. The agent engine is built into the app — drop in an API key and you’re running in minutes.

Quick Start

Install Headmaster and run your first conversation in under 5 minutes.

Specialists

20+ built-in AI personas, each with a specific role and skill set.

The Council

Multi-agent parallel deliberation for complex, multi-perspective problems.

Models & Providers

Connect OpenAI, Anthropic, Google, OpenRouter, local models, and 25+ more.

The Schedule

Recurring automated tasks — daily reports, inbox triage, nightly backups.

Channels

Reach your agent via Telegram, WeChat Work, DingTalk, Lark, and more.

​
What Headmaster does

Headmaster is not a chatbot. It’s a local workspace where one or more AI agents do real work:

Code & Dev

Read your repo, write patches, run tests, commit — without leaving the desktop.

Documents

Generate decks, spreadsheets, reports, and PDFs in native Office formats.

Web Automation

Open pages, fill forms, take screenshots, scrape content — full browser control.

Image Generation

Text-to-image and image editing from chat, using Gemini, OpenAI, Flux, and more.

Scheduled Tasks

Cron-based recurring work with Keep-awake for 24/7 automation.

Messaging Channels

Drive your agent from your phone via Telegram, WhatsApp, iMessage, and more.

​
System requirements

  • Windows 10 or later (64-bit)
  • 4 GB RAM minimum, 8 GB recommended
  • 500 MB storage minimum, 2 GB recommended

​
Key sections

New to Headmaster? Start with Getting Started. Come back to explore the advanced features once you’re up and running.
These docs cover Headmaster v0.2.1. Open source under Apache 2.0.