Metadata-Version: 2.4
Name: denes-embedder
Version: 0.1.0
Summary: HTTP client SDK for DenesGPT embedder service
Author-email: DenesGPT Team <gti@tecnoedil.com.py>
License: Proprietary
Keywords: client,embeddings,http,nlp,rag
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: httpx<0.29,>=0.27
Provides-Extra: dev
Requires-Dist: pytest-asyncio<0.26,>=0.24; extra == 'dev'
Requires-Dist: pytest<9.0,>=8.3; extra == 'dev'
Requires-Dist: ruff<0.10,>=0.8; extra == 'dev'
Provides-Extra: server
Requires-Dist: fastapi<0.120.0,>=0.115.0; extra == 'server'
Requires-Dist: flagembedding<2.0,>=1.2; extra == 'server'
Requires-Dist: pydantic-settings<3.0,>=2.4; extra == 'server'
Requires-Dist: pydantic<3.0,>=2.8; extra == 'server'
Requires-Dist: python-dotenv<2.0,>=1.0; extra == 'server'
Requires-Dist: rich<15.0,>=13.7; extra == 'server'
Requires-Dist: safetensors<0.5,>=0.4; extra == 'server'
Requires-Dist: sentencepiece<0.3,>=0.2; extra == 'server'
Requires-Dist: torch>=2.5.0; extra == 'server'
Requires-Dist: transformers<4.50,>=4.45; extra == 'server'
Requires-Dist: typer<0.16.0,>=0.12.0; extra == 'server'
Requires-Dist: uvicorn[standard]<0.35.0,>=0.30.0; extra == 'server'
Description-Content-Type: text/markdown

# DenesGPT Embedder SDK

HTTP client SDK for the DenesGPT embedder service. The server runs on a GPU VM
and this package only talks to it via HTTP.

## Install (client)

```bash
pip install denes-embedder
```

## Quick start

```python
from denes_embedder import Client

client = Client(
    api_key="YOUR_API_KEY",
    base_url="https://embedder.your-domain.com",
)

response = client.embed(texts=["Hola mundo"])
embedding = response.embeddings.float_[0]
```

## Env vars

- `DENES_EMBEDDER_API_KEY`
- `DENES_EMBEDDER_BASE_URL`
- Legacy support: `EMBEDDER_API_KEY`, `EMBEDDER_BASE_URL`

## Local install (like denes-router-classifier)

```bash
cd denes-backend-python
uv add ../denes-embedder
```

## Server (optional)

The server in this repo is unchanged. If you reinstall it from scratch, use the
`server` extra to pull FastAPI, torch, and model dependencies:

```bash
cd denes-embedder
uv sync --extra server
uv run python cli.py serve
```

## Health check

```python
from denes_embedder import Client

client = Client(api_key="YOUR_API_KEY", base_url="https://embedder.your-domain.com")
status = client.health()
print(status)
```

## Documentation

Documentacion completa: [docs/denes-embedder/denes-embedder.md](../docs/denes-embedder/denes-embedder.md)

## License

Proprietary - Tecnoedil SA
