Official Python SDK for SinricPro - Control your IoT devices with Alexa and Google Home.

• ✅ Easy to Use - Simple, pythonic API with async/await support
• ✅ Type Safe - Full type hints for better IDE support and error detection
• ✅ Voice Control - Works with Alexa and Google Home
• ✅ Real-time - WebSocket-based bidirectional communication
• ✅ Secure - HMAC-SHA256 message signatures
• ✅ Reliable - Auto-reconnection and heartbeat monitoring
• ✅ Flexible - Support for multiple device types and capabilities
• ✅ Cross-Platform - Works on Linux, Windows, macOS, and Raspberry Pi

Lighting & Switches:

• Smart Switch - On/Off control
• Smart Light - RGB color, brightness, color temperature
• Dimmable Switch - On/Off with brightness control

Sensors:

• Motion Sensor - Detect movement
• Contact Sensor - Door/window open/closed detection
• Temperature Sensor - Temperature and humidity monitoring
• Air Quality Sensor - PM1.0, PM2.5, PM10 measurements
• Power Sensor - Voltage, current, power monitoring

Control Devices:

• Blinds - Position control (0-100%)
• Garage Door - Open/close control
• Smart Lock - Lock/unlock control

Climate Control:

• Thermostat - Temperature control with modes (AUTO, COOL, HEAT, ECO)
• Window AC - Air conditioning control

Other Devices:

• Fan - On/Off control
• Doorbell - Doorbell press events

pip install sinricpro

• Python 3.10 or higher
• websockets library (automatically installed)

The SDK works on:

• Linux (Ubuntu, Debian, Raspberry Pi OS, etc.)
• Windows 10/11
• macOS 10.14+
• Raspberry Pi (All models with Python 3.10+)

Enable debug logging to see detailed information:

from sinricpro import SinricProLogger, LogLevel

# Set log level
SinricProLogger.set_level(LogLevel.DEBUG)

Available log levels: DEBUG, INFO, WARN, ERROR, NONE

# Clone the repository
git clone https://github.com/sinricpro/python-sdk.git
cd python-sdk

# Install development dependencies
pip install -e ".[dev]"

# Import sinricpro for development.
```python
import sys
from pathlib import Path
from typing import Any

sys.path.insert(0, str(Path(__file__).parent.parent.parent))

from sinricpro import SinricPro, SinricProAirQualitySensor, SinricProConfig

pytest

black .

mypy sinricpro

# Set environment variables
export SINRICPRO_APP_KEY="your-app-key"
export SINRICPRO_APP_SECRET="your-app-secret"

# Run an example
python examples/switch/switch_example.py

Full API documentation is available at Read the Docs (Coming soon!)

1. Check credentials - Ensure APP_KEY and APP_SECRET are correct
2. Check device ID - Verify the device ID is exactly 24 hexadecimal characters
3. Check network - Ensure you have internet connectivity
4. Enable debug logging - Set debug=True in config to see detailed logs

"Invalid app_key format"

• App key must be a valid UUID (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)

"Invalid app_secret: must be at least 32 characters"

• App secret must be at least 32 characters long

"Invalid device_id format"

• Device ID must be exactly 24 hexadecimal characters

• Documentation: help.sinric.pro
• Community: Discord
• Issues: GitHub Issues
• Email: support@sinric.com

Copyright (c) 2019-2025 Sinric. All rights reserved.

This project is licensed under the Creative Commons Attribution-Share Alike 4.0 International License (CC BY-SA 4.0) - see the LICENSE file for details.

You are free to share and adapt this work for any purpose (including commercially), as long as you give appropriate credit and distribute your contributions under the same license.

• Based on the official SinricPro C++ SDK
• Inspired by the SinricPro Node.js SDK

• SinricPro ESP8266/ESP32 SDK
• SinricPro Node.js SDK
• SinricPro Documentation

If you are to develop agent via vibe coding the llms.txt and the llms-full.txt can be used as context to LLM. While the former one is a summarized one and the later one has the full information in case your LLM has big enough context window.

Made with ❤️ by the SinricPro Team