Metadata-Version: 2.4
Name: hseek
Version: 1.0.0
Summary: The official Python SDK for hDeepSeek Private AI.
Home-page: https://hussain.rinet.ai
Author: Hussain Alkhatib
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.24.0
Requires-Dist: python-dotenv>=1.0.0
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# hSeek Python SDK (hseek)

The official Python SDK for Hussain's Private AI Bridge (hDeepSeek).

## Features
- **Ultra-simple Initialization:** Automatically loads your API key from `.env`.
- **Auto-Memory Management:** Just pass a `session_id` string and the SDK handles the rest.
- **Full Control:** Toggle `thinking` and `search` on a per-message basis.
- **Async & Sync Support:** Built-in `Client` and `AsyncClient`.
- **Streaming Support:** Real-time character-by-character output via `.stream_chat()`.

## Installation

```bash
pip install hseek
```

## Quick Start

Make sure you have a `.env` file with your secret key:
```env
MY_SECRET_API_KEY=your_super_secret_key_here
```

### Basic Example (Sync)

```python
from hseek import Client

ai = Client()

response = ai.chat(
    "Hello! How are you?", 
    session_id="user_123", 
    thinking=True
)

print(response.text)
# If thinking=True, you can also print(response.thinking_text)
```

### Streaming Example (Async)

```python
import asyncio
from hseek import AsyncClient

async def main():
    ai = AsyncClient()
    
    async for chunk in ai.stream_chat("Write a long story.", session_id="user_123"):
        # chunk is an HSeekResponse object that updates in real-time
        print(chunk.text, end="", flush=True)

asyncio.run(main())
```
