Metadata-Version: 2.4
Name: omnimind-sdk
Version: 1.0.0
Summary: OmniMind Protocol Python SDK for AIoT Devices
Author-email: XiaoRGEEK <support@xiaorgeek.com>
Project-URL: Homepage, https://github.com/xiaorgeek/omnimind-sdk
Project-URL: Bug Tracker, https://github.com/xiaorgeek/omnimind-sdk/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: protobuf>=4.0.0
Requires-Dist: websocket-client>=1.0.0
Provides-Extra: audio
Requires-Dist: pyaudio; extra == "audio"
Provides-Extra: utils
Requires-Dist: keyboard; extra == "utils"

# OmniMind Python SDK

OmniMind SDK is a high-performance communication library for AIoT devices using the OmniMind Protocol. It supports real-time voice streaming, text messaging, and hardware tool registration (MCP).

## Installation

```bash
pip install omnimind-sdk
```

If you need audio support (optional):
```bash
pip install omnimind-sdk[audio]
```

## Quick Start

```python
from omnimind import OmniMindClient

def on_text(content, role):
    print(f"[{role}] {content}")

client = OmniMindClient(
    server_url="ws://127.0.0.1:8082/v1/ws",
    sn="YOUR_DEVICE_SN",
    token="YOUR_TOKEN"
)

client.set_text_callback(on_text)
client.connect()

client.send_text("Hello, who are you?")
```

## Features

- **Real-time Voice**: Stream audio chunks using Opus/PCM.
- **Tool Registration**: Register hardware capabilities as tools for AI to call.
- **Heartbeat**: Automatic PING/PONG mechanism to keep connection alive.
- **Protobuf**: Efficient binary serialization.

## License

MIT
