Skip to main content

bigRAG Python SDK

Async Python client for the bigRAG API.

pip install bigrag
import asyncio

from bigrag import BigRAG


async def main() -> None:
    async with BigRAG(api_key="bigrag_sk_...", base_url="http://localhost:4000") as client:
        doc = await client.documents.upload("docs", "/path/to/paper.pdf")
        result = await client.queries.query("docs", {"query": "What is RAG?"})
        print(doc["id"], result["total"])


asyncio.run(main())

The SDK is fully typed, ships py.typed, and uses CalVer releases like 2026.5.22.

Namespaces

  • client.collections for collection CRUD, stats, re-embedding, event tokens, and event streams.
  • client.documents for uploads, batch operations, file URLs, and status polling.
  • client.queries for single, multi-collection, and batch retrieval queries.
  • client.vectors for raw vector upsert and delete.
  • client.webhooks for webhook management and delivery replay.
  • client.auth for session login, setup, preferences, and identity.
  • client.admin for users, API keys, access logs, audit logs, runtime settings, backups, vector storage overview, admin realtime streams, connector config, embedding presets, and MCP server keys.
  • client.connectors.google for Google Drive account, file browsing, sources, and sync jobs.
  • client.evaluations for golden-set retrieval evaluations.

Authentication

API-key endpoints accept api_key or the BIGRAG_API_KEY environment variable. Session-only admin endpoints can be used after calling client.auth.login(...) or client.auth.setup(...); the client keeps the session cookie in its underlying httpx.AsyncClient.

Versioning

Published artifacts use CalVer in the form YYYY.M.D.

Metadata

Release files for bigrag 2026.5.22

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bigrag 2026.5.22
File Size Uploaded Provenance Actions
bigrag-2026.5.22.tar.gz 21.9 kB Without provenance Details for bigrag-2026.5.22.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for bigrag 2026.5.22
File Interpreter ABI Platform Actions
bigrag-2026.5.22-py3-none-any.whl Python 3 none any Details for bigrag-2026.5.22-py3-none-any.whl

Total release size: 60.1 kB

Release files / bigrag-2026.5.22.tar.gz

Download URL bigrag-2026.5.22.tar.gz
Size 21.9 kB
Tags Source
SHA-256 checksum
How to use checksums
b540ff986cbf89de1cd53d96fae73e9bc08926377a394faba8b414b425555e45
BLAKE2b-256 checksum
How to use checksums
4196b37c9183c3990df62a7cb097c6cfc75e5f21d3e3be6056f4ba5b1e0b42f2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12

Release files / bigrag-2026.5.22-py3-none-any.whl

Download URL bigrag-2026.5.22-py3-none-any.whl
Size 38.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ac36999dcc07a1a7c029fed98d6dc8b6a58b1ef6a26c247e9607e3380ac0efb4
BLAKE2b-256 checksum
How to use checksums
4143b99595a685ef4326483cbd121091be1812b6ea2ada4f9953d446efbb24a7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12

Security for bigrag 2026.5.22

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page