# whatsy

## Docs

- [Behavior Rules: control how Whatsy handles messages](https://docs.whatsy.ai/concepts/behavior-rules.md): Behavior rules let you define conditions and actions so Whatsy can skip, archive, notify, or route messages before the LLM is ever invoked.
- [How Whatsy receives, evaluates, and replies to messages](https://docs.whatsy.ai/concepts/how-it-works.md): Learn how Whatsy's local pipeline receives WhatsApp messages, applies behavior rules, builds context, and generates replies with Ollama.
- [Personas: teach Whatsy to write exactly like you do](https://docs.whatsy.ai/concepts/personas.md): A Whatsy persona defines your tone, style, and example replies. The active persona is used by the local LLM to match how you actually write.
- [Privacy and data security in Whatsy for macOS users](https://docs.whatsy.ai/concepts/privacy.md): Whatsy is built local-first: all messages, personas, and session data stay on your Mac. No telemetry, no cloud AI, no external data sharing.
- [Set up Whatsy behavior rules to control auto-replies](https://docs.whatsy.ai/guides/behavior-rules.md): Create behavior rules to skip, archive, or reroute messages before the AI replies — filter spam, set contact-specific responses, and more.
- [How to link your WhatsApp account to Whatsy on macOS](https://docs.whatsy.ai/guides/connecting-whatsapp.md): Scan Whatsy's QR code from your iPhone or Android to link your WhatsApp account in seconds — no new phone number or SIM card required.
- [Create a Whatsy persona that matches your writing style](https://docs.whatsy.ai/guides/creating-a-persona.md): Build a Whatsy persona by defining your tone, writing style instructions, and example reply pairs so the LLM matches how you actually write.
- [Monitor your agent activity from the Whatsy dashboard](https://docs.whatsy.ai/guides/dashboard.md): The Whatsy dashboard shows your agent's activity feed, recent conversations, reply logs, and lets you review what the AI sent on your behalf.
- [Configure Whatsy settings for auto-reply and filtering](https://docs.whatsy.ai/guides/settings.md): Adjust Whatsy's response delay, contact filters, spam filtering, and WhatsApp connection from the Settings panel in the Whatsy macOS app.
- [Whatsy: autonomous WhatsApp replies in your own voice](https://docs.whatsy.ai/introduction.md): Whatsy is a local-first macOS app that reads WhatsApp messages and replies as you — powered by a local AI model, with no cloud data sharing.
- [How to set up Whatsy and send your first auto-reply](https://docs.whatsy.ai/quickstart.md): Download the Whatsy macOS app, install Ollama, link your WhatsApp by scanning a QR code, and send your first auto-reply in minutes.
- [System requirements for installing Whatsy on macOS](https://docs.whatsy.ai/requirements.md): Check what your Mac needs before installing Whatsy: macOS 14 or later, Google Chrome, and a locally-running Ollama instance with at least one model pulled.
- [Troubleshoot the most common Whatsy problems on macOS](https://docs.whatsy.ai/troubleshooting/common-issues.md): Solutions to the most common Whatsy problems: agent not starting, replies not sending, QR not appearing, and Ollama connectivity issues.
- [How to install and configure Ollama for Whatsy on macOS](https://docs.whatsy.ai/troubleshooting/ollama-setup.md): Install Ollama on macOS, download the llama3.2 model, and verify Whatsy can connect to the local LLM before enabling auto-replies.
- [Fix WhatsApp connection and QR code problems in Whatsy](https://docs.whatsy.ai/troubleshooting/whatsapp-connection.md): Resolve WhatsApp linking failures, expired or missing QR codes, unexpected session disconnects, and Chrome-related errors in Whatsy on macOS.