Skip to main content
Headmaster is a desktop workspace where AI specialists handle real work on your machine: reading files, writing code, browsing the web, generating images, and automating tasks through scheduled jobs.

What you’ll find here

GuideWhat it coversRead time
Getting StartedDownload, install, first conversation5 min
The Local RuntimeHow the agent engine works8 min
Models & ProvidersConnecting to AI platforms12 min
ConversationsChat, sessions, and steering10 min
The CouncilMulti-agent parallel work6 min
Specialists20+ built-in personas8 min
Skills & The AgencyInstalling community abilities7 min
ChannelsMessaging platform connections10 min
The ScheduleRecurring automated tasks8 min
TroubleshootingCommon issues and fixes10 min

Getting Started

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

Models & Providers

Connect OpenAI, Anthropic, Google, OpenRouter, or local models.

The Council

Run multiple specialists in parallel for complex tasks.

Channels

Connect Telegram, WeChat Work, DingTalk, Lark, and more.

System requirements

  • Windows: Windows 10 or later (64-bit)
  • macOS: macOS 10.14 (Mojave) or later (Intel and Apple Silicon)
  • Linux: Ubuntu 18.04+, Fedora 30+, Debian 10+, or equivalent

Version

These docs cover Headmaster v0.2.1.
New to Headmaster? Start with Getting Started and come back to explore advanced features once you’re running.