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

# Whatsy: Your autonomous WhatsApp assistant

> Whatsy replies on WhatsApp as you when you're unavailable, using a local LLM so no message data ever leaves your Mac.

Whatsy is a local-first autonomous messaging assistant for macOS. It monitors your WhatsApp and sends replies in your personal tone whenever you're unavailable — powered by [Ollama](https://ollama.com) running entirely on your machine. No cloud AI, no third-party message processing, no data leaving your device.

<CardGroup cols={2}>
  <Card title="Introduction" icon="book-open" href="/introduction">
    Learn what Whatsy does, how it works, and who it's built for.
  </Card>

  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Download Whatsy, link your WhatsApp, and get your first auto-reply working.
  </Card>

  <Card title="Personas" icon="user-circle" href="/concepts/personas">
    Build a persona that captures your tone, style, and example replies.
  </Card>

  <Card title="Behavior Rules" icon="sliders" href="/concepts/behavior-rules">
    Control exactly which messages Whatsy replies to — and how.
  </Card>
</CardGroup>

## How it works

<Steps>
  <Step title="Download the macOS app">
    Get the Whatsy app for macOS and open it on your Mac.
  </Step>

  <Step title="Link your WhatsApp">
    Scan a QR code inside the app. Whatsy connects to your existing WhatsApp account — no new number needed.
  </Step>

  <Step title="Set up your persona">
    Describe your tone and add a few example replies. Whatsy uses this to match how you actually write.
  </Step>

  <Step title="Turn on auto-replies">
    Enable auto-replies when you're ready. Whatsy handles incoming messages while you're away.
  </Step>
</Steps>

<Note>
  All message content, persona data, and your WhatsApp session are stored exclusively on your Mac. Whatsy does not send any of this to external servers.
</Note>

## Explore the docs

<CardGroup cols={3}>
  <Card title="Requirements" icon="list-check" href="/requirements">
    Check macOS version and dependency requirements before installing.
  </Card>

  <Card title="How It Works" icon="microchip" href="/concepts/how-it-works">
    Understand Whatsy's local-first architecture and reply pipeline.
  </Card>

  <Card title="Privacy Model" icon="shield-halved" href="/concepts/privacy">
    See exactly what stays on your device and what never leaves it.
  </Card>

  <Card title="Connecting WhatsApp" icon="qrcode" href="/guides/connecting-whatsapp">
    Step-by-step guide to scanning the QR and linking your account.
  </Card>

  <Card title="Dashboard" icon="gauge" href="/guides/dashboard">
    Monitor activity, review conversations, and manage your agent.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/troubleshooting/common-issues">
    Fix common issues with Ollama, WhatsApp linking, and replies.
  </Card>
</CardGroup>