# Documentation

How to install, use and set up ASIST, and how it handles your data.

ASIST is a realtime assistant for Mac and Windows that answers you by voice when you talk to it. It shows the weather, your events and your mail on cards beside the conversation. Longer research and file edits go to an Agent (the codex or claude CLI) once you approve them.

![The ASIST home screen, with the conversation in the middle, an exchange rate card on the left, a weather card on the right and the Dock at the bottom](https://asist-agent.com/screens/en/home.webp)

- [Getting started](https://asist-agent.com/en/docs/start/): What you need, installation, first-time setup, permissions and setting up the Agent
- [Using ASIST](https://asist-agent.com/en/docs/usage/): How to talk to ASIST, and the cards
- [Mini apps](https://asist-agent.com/en/docs/apps/agent/): Agent, tasks, notes, memory, mail, calendar, map and files
- [Connecting your calendar and mail](https://asist-agent.com/en/docs/start/calendar/): Google Calendar, Gmail and iCloud
- [Settings](https://asist-agent.com/en/docs/settings/): Appearance, language and region, models, voice and Agent
- [Safety and privacy](https://asist-agent.com/en/docs/privacy/safety/): Using ASIST safely, where your data is kept, and what is sent out
- [Troubleshooting](https://asist-agent.com/en/docs/troubleshooting/): Microphone, voice, API keys and logs
- [Reference](https://asist-agent.com/en/docs/reference/models/): The models ASIST uses, how much memory they need, and what is bundled

To run ASIST from source, build it or make a release, see [docs/development.md](https://github.com/nyosegawa/asist/blob/main/docs/development.md) on GitHub.