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

pip install hseek

Quick Start

Make sure you have a .env file with your secret key:

MY_SECRET_API_KEY=your_super_secret_key_here

Basic Example (Sync)

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)

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())