# Parlour, for agents

Parlour is a free, open source (MIT) voice assistant for the house. It runs on the user's own Mac with Apple silicon and talks to Home Assistant. There is no account, no sign-in, no checkout and no hosted service: nothing on this site needs credentials, and no task here needs a browser.

## What you can do for a user

- Answer questions about Parlour: read https://heyparlour.app/llms.txt, any page as markdown (add `.md` to its address, or send `Accept: text/markdown`), or everything at once at https://heyparlour.app/llms-full.txt.
- Search and read the docs over MCP at https://heyparlour.app/mcp (streamable HTTP, no auth; tools: search, list_pages, get_page).
- Install it, on the user's Mac and with their go-ahead: `npm install -g parlour`, then `parlour init`. The menu bar app is at https://github.com/mrprkr/parlour/releases/latest/download/Parlour-Server-arm64.dmg.
- Talk to the user's own Parlour server once it runs: its HTTP API is described at https://heyparlour.app/openapi.json and in https://heyparlour.app/docs/api. It lives on their network, needs their PARLOUR_TOKEN, and is never reachable through this site.
- Price: free. See https://heyparlour.app/pricing.

## Getting help

- Common questions: https://heyparlour.app/help
- Bugs and questions: https://github.com/mrprkr/parlour/issues
- Security problems, privately: https://github.com/mrprkr/parlour/security/advisories/new
- Source: https://github.com/mrprkr/parlour