bigRAG
Development

Releases

Release versioning and publish paths for bigRAG artifacts.

Versioning

bigRAG release artifacts use CalVer with the YYYY.M.D scheme. Month and day are not zero-padded, so a release on May 23, 2026 is 2026.5.23.

Coordinated platform releases should align API package metadata, SDK package metadata, SDK user-agent constants, Docker image tags, and docs examples on the same CalVer version. SDK-only releases can ship independently from the API, admin UI, and docs packages.

Publish paths

  • Docker images read the version from api/pyproject.toml and publish dated tags plus latest.
  • The Python SDK workflow validates sdks/python/pyproject.toml and publishes tags named python-sdk-v<version> to PyPI.
  • The TypeScript SDK is published manually to npm from the CalVer version in sdks/typescript/package.json.

Testing

Current verification workflow for bigRAG changes.

Migrate from Pinecone

Move an existing Pinecone index to bigRAG with one importer script — API mapping, chunking considerations, and a reusable migration pattern.

On this page

VersioningPublish paths