# Haypile

Haypile is private search and Q&A for your documents: one binary that
watches folders, indexes PDF, Word, Markdown, and text files, and answers
questions with citations to the exact file and page. It runs fully
locally. The embedding model ships inside the binary, the index is one
SQLite file, and the software makes zero outbound network connections
(verifiable with `hay status`).

Install: `brew install BenyD/tap/hay` (macOS) or
`curl -fsSL haypile.sh | sh` for Linux. Open source, AGPL-3.0.

For AI agents: the daemon exposes MCP (Streamable HTTP) at
http://localhost:11500/mcp with tools `search_documents` and
`list_sources`, and a REST API at /api/query. Connect Claude Code with:
`claude mcp add --transport http haypile http://localhost:11500/mcp`

# Docs

- [Getting started](/docs): From install to your first semantic search in under two minutes.
- Guides
  - [Search your documents](/docs/guides/search): Get the most out of hybrid search, tags, and citations.
  - [Ask questions with a local LLM](/docs/guides/ask): Turn search results into direct, cited answers using Ollama or any OpenAI-compatible server.
  - [Scanned PDFs (OCR)](/docs/guides/scanned-pdfs): Index image-only PDF pages by transcribing them with your local vision model.
  - [Use the web UI](/docs/guides/web): Search, ask, and manage sources from your browser, served locally by the daemon.
  - [Use Haypile from Claude Code](/docs/guides/claude-code): Give AI coding agents your local documents as a knowledge source over MCP.
  - [Configure a folder](/docs/guides/folders): Per-folder tags and exclude patterns with hay init and .haypile.yml.
  - [Manage, update, uninstall](/docs/guides/manage): The daemon lifecycle, upgrading Haypile, and removing every trace of it.
- Reference
  - [CLI commands](/docs/reference/cli): Every hay command, flag, and environment variable.
  - [REST API](/docs/reference/api): The daemon's HTTP API on localhost:11500, plus the MCP endpoint.
  - [Configuration](/docs/reference/configuration): The .haypile.yml per-folder config file and the data directory.
  - [Troubleshooting](/docs/reference/troubleshooting): The errors you might actually see, what they mean, and the fix.
- Understand
  - [How search works](/docs/explanation/how-it-works): The pipeline from a saved file to a cited answer, and why it is built this way.
  - [Privacy, verified](/docs/explanation/privacy): What "zero external connections" means, how to check it, and where the boundaries are.