Micropython-SinricPro SDK

The simple way to control your MicroPython board with Amazon Alexa, Google Home, SmartThings, Homebridge and Node-RED.

Now supports local control over LAN, keeping devices responsive to the SinricPro app even when the SinricPro cloud is unreachable.

Tutorials:

• How to turn on and off a Relay (ESP32)

Which device types are working as of now?

Device Type	Supported ?	Example
Switch	Completed	here
Blinds	Completed	here
Dimmable Switch	Completed	here
Fan	Completed	here
Garage Door	Completed	here
Light	Completed	here
Lock	Completed	here
Thermostat	Completed	here
TV	Completed	here
AC Unit	Completed	here
Temperature Sensor	Completed	here
Motion Sensor	Completed	here
Contact Sensor	Completed	here
Speaker	Completed	here
Custom Device Types	Pending	-

How do I install it?

Using mpremote: (pip install --user mpremote)

make sure device is not connected to IDE

mpremote mip install github:sinricpro/micropython-sinricpro-sdk 

or

py -m mpremote connect <COM_PORT> mip install github:sinricpro/micropython-sinricpro-sdk

Using mip (in REPL):

import mip
mip.install("github:sinricpro/micropython-sinricpro-sdk")

SinrciPro library will be installed in the /lib folder. You can manually copy the sinricpro folder to /lib as well

Local Control (LAN/UDP)

From v3.0.0 the SDK answers signed commands directly over the local network, so a device keeps responding to the SinricPro app while the cloud is unreachable. Local control is enabled by default. It listens on UDP 3333 and dispatches through the same callbacks as cloud requests, so existing code needs no changes.

The listener supports unicast, multicast (group 224.9.9.9), and subnet broadcast.

There is no mDNS announcement: MicroPython has no portable way to publish a service record. The app discovers these devices by broadcasting a signed probe instead, which needs nothing extra on the device and works on networks that drop multicast.

To turn it off:

sinricpro.start(APP_KEY, APP_SECRET, local_control=False)

How can I use it?

Checkout the examples directory.

Will it run on Microcontroller X?

Tested on

1. MicroPython v1.27.0 on 2025-12-09 Generic ESP32 module with ESP32

2. MicroPython v1.27.0 on 2025-12-09; Raspberry Pi Pico W with RP2040

For development using PyMakr:

1. Install Micropython (https://docs.micropython.org/en/latest/esp32/tutorial/intro.html)
2. Install PyMakr in VSCode
3. VSCode -> Open Workspace from File -> micropython-sinricpro-sdk.code-workspace
4. Create a new file called main.py to code.
5. Connect to ESP32 in PyMakr -> Upload -> Hardreset device.
6. Please use Pylint for formatting (https://marketplace.visualstudio.com/items?itemName=ms-python.pylint)

Tutorial: How to Control a Relay (Turn On/Off) Using MicroPython on an ESP32 with Pymakr

For development using Thonny:

1. Install Micropython (https://docs.micropython.org/en/latest/esp32/tutorial/intro.html](https://projects.raspberrypi.org/en/projects/get-started-pico-w/1)
2. Install SinricPro library

Tutorial: How to Control a Relay (Turn On/Off) Using MicroPython on an Raspberry Pi Pico W with Thonny

To remove the library manually:

import mip
mip.install("shutil")
import shutil
shutil.rmtree("/lib/sinricpro")

To list files in ESP32 or PICOW

import os
def listdir(dir):
    for i in os.listdir(dir):
        print('{}/{}'.format(dir,i))
    
listdir("/")

Join the community!

Join us on our Official Discord Server!