Metadata-Version: 2.4
Name: talqora
Version: 0.0.2
Summary: Official Python SDK for the Talqora Vector API.
Requires-Python: >=3.10,<4.0
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: OS Independent
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.15
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Provides-Extra: aiohttp
Requires-Dist: aiohttp (>=3.14.1,<4) ; (python_version >= "3.10") and (extra == "aiohttp")
Requires-Dist: httpx (>=0.21.2)
Requires-Dist: httpx-aiohttp (>=0.1.8,<0.2.0) ; (python_version >= "3.10") and (extra == "aiohttp")
Requires-Dist: pydantic (>=1.9.2)
Requires-Dist: pydantic-core (>=2.18.2,<3.0.0)
Requires-Dist: typing_extensions (>=4.0.0)
Project-URL: Repository, https://talqora.com
Description-Content-Type: text/markdown

# Talqora Vector Python SDK

Official Python client for Talqora Vector: regional indexes, dense vectors, sparse BM25 retrieval, hybrid search, asynchronous file processing, and RAG workloads.

## Install

```bash
pip install talqora
```

## Authenticate

Set `TALQORA_API_KEY` or pass a `tq_live_` API key directly:

```python
import os
from talqora import TalqoraApi

client = TalqoraApi(
    talqora_api_key=os.environ["TALQORA_API_KEY"],
)
```

## What you can build

- Create and manage regional indexes with immutable dimensions and distance metrics.
- Write, delete, and query dense vectors with filterable metadata.
- Run sparse BM25 or hybrid dense+sparse retrieval.
- Upload files and monitor asynchronous extraction, OCR, chunking, and embedding jobs.
- Manage API keys, organization usage, branches, connectors, assistants, and webhooks.

## Documentation

- API reference: https://docs.talqora.com
- SDK guide: https://docs.talqora.com/sdk
- Package source and releases: https://pypi.org/project/talqora/

## Example

```python
from talqora import TalqoraApi

client = TalqoraApi(talqora_api_key="tq_live_...")
```

Pin the package version in production and consult the API reference for endpoint-level request and response details.

