Metadata-Version: 2.5
Name: passageway
Version: 0.3.0
Summary: Retrieval for Claude over MCP: connectors feed passages, an eval harness keeps them honest
License-Expression: PolyForm-Noncommercial-1.0.0
License-File: LICENSE
License-File: LICENSE-FREE-TRIAL
Requires-Python: >=3.12
Requires-Dist: fastmcp>=3.0.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: mcp-login-oauth>=0.2.3
Requires-Dist: numpy>=2.0
Requires-Dist: onnxruntime>=1.20
Requires-Dist: pyyaml>=6.0
Requires-Dist: sentencepiece>=0.2.2
Requires-Dist: sqlite-vec>=0.1.6
Requires-Dist: starlette>=0.40
Requires-Dist: tokenizers>=0.20
Requires-Dist: truststore>=0.10
Requires-Dist: uvicorn>=0.30
Provides-Extra: all
Requires-Dist: passageway-connector-confluence==0.3.0; extra == 'all'
Requires-Dist: passageway-connector-llmstxt==0.3.0; extra == 'all'
Requires-Dist: passageway-connector-markdown==0.3.0; extra == 'all'
Requires-Dist: passageway-connector-sitemap==0.3.0; extra == 'all'
Requires-Dist: passageway-connector-trilium==0.3.0; extra == 'all'
Requires-Dist: passageway-connector-wikipedia==0.3.0; extra == 'all'
Requires-Dist: passageway-embedder-openai==0.3.0; extra == 'all'
Provides-Extra: confluence
Requires-Dist: passageway-connector-confluence==0.3.0; extra == 'confluence'
Provides-Extra: llmstxt
Requires-Dist: passageway-connector-llmstxt==0.3.0; extra == 'llmstxt'
Provides-Extra: markdown
Requires-Dist: passageway-connector-markdown==0.3.0; extra == 'markdown'
Provides-Extra: openai
Requires-Dist: passageway-embedder-openai==0.3.0; extra == 'openai'
Provides-Extra: sitemap
Requires-Dist: passageway-connector-sitemap==0.3.0; extra == 'sitemap'
Provides-Extra: trilium
Requires-Dist: passageway-connector-trilium==0.3.0; extra == 'trilium'
Provides-Extra: wikipedia
Requires-Dist: passageway-connector-wikipedia==0.3.0; extra == 'wikipedia'
Description-Content-Type: text/markdown

# passageway

**The answer is hidden somewhere across your sources. passageway finds it.**

passageway searches all your sources at once, wiki, notes and documentation, and gives your agent exactly the passages that answer the question, each linked to its source.

- **On premise.** Your knowledge stays on your infrastructure.
- **Connected.** Confluence, Trilium, Markdown and Wikipedia work out of the box.
- **Open.** A documented protocol lets you add any source or embedding model, in any language.

Free for private use. Companies need a licence ([details](docs/licence.md)); trying it at work for fewer than 32 days is covered by the PolyForm Free Trial licence (`LICENSE-FREE-TRIAL`).

It serves the passages as one `recall` tool over MCP, stays silent when nothing is relevant enough, and does no generation: the calling agent reads the passages. An [eval harness](docs/guides/evaluate.md) (`passageway eval`) measures retrieval quality on your own questions, so you can publish the numbers.

- [Install and run](docs/install.md) and [configuration](docs/configuration.md)
- [How it works](docs/how-it-works.md)
- [What passageway stands for](docs/values.md): the yardstick for every change
- [Run it](docs/deploy.md) as a local service or as the container `ghcr.io/getpassageway/passageway`; in [Claude Code](docs/guides/claude-code.md), the plugin installs and connects it for you and brings the prompt hook
- [Write a connector](docs/guides/write-a-connector.md), the [connector protocol](docs/reference/connector-protocol.md) and the [Python SDK](docs/reference/sdk.md) that does its plumbing
- Bundled connectors: [Wikipedia](connectors/wikipedia/README.md), [Markdown](connectors/markdown/README.md), [llms.txt](connectors/llmstxt/README.md), [Sitemap](connectors/sitemap/README.md), [Trilium](connectors/trilium/README.md), [Confluence](connectors/confluence/README.md); bundled embedder: [OpenAI-compatible](embedders/openai/README.md)
- For AI agents: [skills and `llms-full.txt`](docs/guides/agents.md); in Claude Code, `/plugin marketplace add getpassageway/passageway` and `/plugin install passageway@passageway` give you the plugin, then `/passageway-install` sets everything up

Documentation: the pages in `docs/`, will be published at https://passageway.marceltov.de.

Status: early. The engine started as the recall engine of [trilium-recall](https://github.com/Marceltov/trilium-recall) and is being generalized. The code is source-available under the PolyForm Noncommercial License 1.0.0 (free for private use; companies need a licence), and the SDK is MIT; the Wikipedia articles of the sample corpus in `corpus/` are CC BY-SA 4.0 (see `corpus/LICENSE.md`).

## Contact

marcel@marceltov.de
