> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gcaplabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Headmaster Documentation

> AI specialists that do real work on your machine — no terminal setup required.

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.

<CardGroup cols={3}>
  <Card title="Quick Start" icon="rocket" href="/getting-started">
    Install Headmaster and run your first conversation in under 5 minutes.
  </Card>

  <Card title="Specialists" icon="users" href="/specialists">
    20+ built-in AI personas, each with a specific role and skill set.
  </Card>

  <Card title="The Council" icon="brain" href="/the-council">
    Multi-agent parallel deliberation for complex, multi-perspective problems.
  </Card>

  <Card title="Models & Providers" icon="cpu" href="/models-providers">
    Connect OpenAI, Anthropic, Google, OpenRouter, local models, and 25+ more.
  </Card>

  <Card title="The Schedule" icon="clock" href="/the-schedule">
    Recurring automated tasks — daily reports, inbox triage, nightly backups.
  </Card>

  <Card title="Channels" icon="message" href="/channels">
    Reach your agent via Telegram, WeChat Work, DingTalk, Lark, and more.
  </Card>
</CardGroup>

***

## What Headmaster does

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

<CardGroup cols={2}>
  <Card title="Code & Dev" icon="code">
    Read your repo, write patches, run tests, commit — without leaving the desktop.
  </Card>

  <Card title="Documents" icon="file-word">
    Generate decks, spreadsheets, reports, and PDFs in native Office formats.
  </Card>

  <Card title="Web Automation" icon="browser">
    Open pages, fill forms, take screenshots, scrape content — full browser control.
  </Card>

  <Card title="Image Generation" icon="image">
    Text-to-image and image editing from chat, using Gemini, OpenAI, Flux, and more.
  </Card>

  <Card title="Scheduled Tasks" icon="calendar">
    Cron-based recurring work with Keep-awake for 24/7 automation.
  </Card>

  <Card title="Messaging Channels" icon="mobile">
    Drive your agent from your phone via Telegram, WhatsApp, iMessage, and more.
  </Card>
</CardGroup>

***

## System requirements

<Tabs>
  <Tab title="Windows">
    * **Windows 10** or later (64-bit)
    * 4 GB RAM minimum, 8 GB recommended
    * 500 MB storage minimum, 2 GB recommended
  </Tab>

  <Tab title="macOS">
    * **macOS 10.14 (Mojave)** or later
    * Intel and Apple Silicon both supported
    * 4 GB RAM minimum, 8 GB recommended
  </Tab>

  <Tab title="Linux">
    * **Ubuntu 18.04+**, Fedora 30+, Debian 10+, or equivalent
    * 4 GB RAM minimum, 8 GB recommended
    * `.deb`, `.AppImage`, and Homebrew install options available
  </Tab>
</Tabs>

***

## Key sections

| Section                                   | What it covers                                    |
| ----------------------------------------- | ------------------------------------------------- |
| [Getting Started](/getting-started)       | Download, install, first conversation             |
| [The Local Runtime](/the-local-runtime)   | How the agent engine works under the hood         |
| [Models & Providers](/models-providers)   | Connecting to 28+ AI platforms                    |
| [Conversations](/conversations)           | Chat, sessions, steering, and file uploads        |
| [Modes](/modes)                           | Work Along, Run It Yourself, Hands-Off, Autopilot |
| [The Council](/the-council)               | Multi-agent parallel deliberation                 |
| [Skills & The Agency](/skills-the-agency) | Installing and authoring agent skills             |
| [Channels](/channels)                     | Messaging platform connections                    |
| [The Schedule](/the-schedule)             | Recurring automated tasks                         |
| [Security](/security)                     | Approval gates, isolation, audit trails           |
| [Troubleshooting](/troubleshooting)       | Common issues and fixes                           |

<Tip>
  New to Headmaster? Start with [Getting Started](/getting-started). Come back to explore the advanced features once you're up and running.
</Tip>

***

*These docs cover **Headmaster v0.2.1**. Open source under Apache 2.0.*