Metadata-Version: 2.4
Name: sdk
Version: 0.1.1
Summary: ErGPT Knowledge Base API SDK
Project-URL: Homepage, https://github.com/your-org/ergpt-sdk
Project-URL: Repository, https://github.com/your-org/ergpt-sdk
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.25.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"

# ErGPT SDK

Python SDK для работы с API ErGPT.

## Документация

- [KB_API_Guide.md](KB_API_Guide.md) — руководство по Knowledge Base API с curl-примерами
- [examples.py](examples.py) — примеры использования SDK на Python

## Установка

## Установка

```bash
pip install --index-url https://git.infra.er-gpt.ru/api/packages/ergpt/pypi/simple sdk
```

## Быстрый старт

### Синхронный клиент

```python
from ergpt.kb import KnowledgeBaseClient

client = KnowledgeBaseClient(api_token="your_token")

# Создать базу знаний
kb = client.create_knowledge_base(
    name="Моя база",
    description="Описание",
    chunk_size=1000,
    chunk_overlap=200,
)

# Загрузить документ
with open("doc.pdf", "rb") as f:
    doc = client.upload_document(kb.id, f)

# Поиск
results = client.search(kb.id, "мой запрос", limit=5)
for r in results.chunks:
    print(r.filename, r.chunks[0].score)
```

### Асинхронный клиент

```python
import asyncio
from ergpt.kb import AsyncKnowledgeBaseClient

async def main():
    async with AsyncKnowledgeBaseClient(api_token="your_token") as client:
        kb = await client.create_knowledge_base(...)
        results = await client.search(kb.id, "запрос")

asyncio.run(main())
```

## Документация

См. [KB_API_Guide.md](KB_API_Guide.md) — подробное руководство по Knowledge Base API.

## Структура пакета

- `ergpt.kb` — Knowledge Base API (базы знаний, документы, поиск)

В будущем:
- `ergpt.chat` — Chat API
- `ergpt.users` — Users API

## Лицензия

MIT
