examples

Polyvia examples

Runnable snippets for the Polyvia API — the Multimodal Document Retrieval API for developers of AI agents.

Grab a key in Polyvia Platform → Settings → API, then export it:

export POLYVIA_API_KEY="poly_<your-key>"

File	What it shows
python_quickstart.py	Ingest one file, wait, then query
batch_group.py	Ingest a batch into a group, then ask one question across all of it
query_scopes.py	Query across all four scopes: workspace, document, group, many groups
groups_and_documents.py	Create/find/list groups; list, get, move and delete documents
async_client.py	AsyncPolyvia — the same surface, awaitable
agent_tool.py	Expose Polyvia retrieval as a tool to your own agent
typescript_quickstart.ts	The ingest → query loop in TypeScript
curl.sh	Raw HTTP — no SDK
mcp/claude_desktop_config.json	Connect Polyvia to Claude Desktop / Cursor via MCP

Run them

# Python
pip install polyvia
python examples/python_quickstart.py path/to/report.pdf

# TypeScript
npm install polyvia
npx tsx examples/typescript_quickstart.ts path/to/report.pdf

Full reference: docs.polyvia.ai.