Metadata-Version: 2.4
Name: ragflow-async-sdk
Version: 0.1.1
Summary: Async Python SDK for RAGFlow
Author: OliverW
License: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Requires-Python: >=3.10
Requires-Dist: httpx<0.30,>=0.28
Provides-Extra: dev
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: pytest-asyncio; extra == 'dev'
Description-Content-Type: text/markdown

# RAGFlow Async SDK

## Overview

An **async-first Python SDK** for interacting with the RAGFlow API.

Provides clean, typed, and production-ready access to RAGFlow features such as:

* Dataset & document management
* Document chunking & ingestion
* File & folder management
* Knowledge Graph (GraphRAG)
* Background tasks (parsing, knowledge construction)
* Chat & Agent sessions with **streaming (SSE) support**

---

## ⚡ Quick Start

### 💿 Installation

Requires **Python 3.10+**.

```bash
pip install ragflow-async-sdk
```

### 🚀 Getting Started

All operations in the RAGFlow SDK are asynchronous. To use the SDK, first initialize the client and then run async calls inside Python's `asyncio` event loop.

#### 🛠 Initialization

```python
from ragflow_async_sdk import AsyncRAGFlowClient

client = AsyncRAGFlowClient(
    server_url="http://your-ragflow-address",
    api_key="YOUR_API_KEY",
)
```

#### ⏩ Run with asyncio

```python
import asyncio

async def main():
    # Example: Health check
    system_health = await client.systems.healthz()
    print(system_health.status)

# Run the async main function
asyncio.run(main())
```

> Notes:
>
> All SDK calls are async; use `await` and `async for` as needed.

---

## 📚 Documentation

📝 [User Guide](docs/user_guide.md)

### ⚡ FastAPI Integration
* [FastAPI Usage Examples](docs/fastapi_usage_examples.md) 

### 🧩 Main Modules

* [Datasets](docs/api_reference.md#-dataset-apis)
* [Documents](docs/api_reference.md#-document-apis)
* [Chunks](docs/api_reference.md#-chunk-apis)
* [Chat Assistants](docs/api_reference.md#-chat-apis)
* [Agents](docs/api_reference.md#-agent-apis)
* [Files](docs/api_reference.md#-file-apis)
* [System](docs/api_reference.md#-system-apis)

### 📖 Full API Reference

* [API Reference](docs/api_reference.md)

### 💡 Error Reference

* [Error Reference](docs/error_reference.md#error-reference)

### 🧬 Entities Reference

* [Entities Reference](docs/entities_reference.md#entities-reference)

### 🧪 Testing

* [Testing Guide](docs/testing_guide.md)

---

## License

Apache License 2.0
