Skip to main content

Wrapper around the Shelly HTTP api

Project description


not to be confused with pyShelly
Python 2 and 3 Wrapper around the Shelly HTTP api


other packages like pyShelly only support CoAP or MSQT, neither I am comfortable with using in personal projects


here is a simple working example for the Shelly 1 that turns a relay on

import ShellyPy

device = ShellyPy.Shelly("")

device.relay(0, turn=True)

this example with comments can be found on examples/



  • Shelly1
  • Shelly1PM
  • Shelly2
  • Shelly2.5
  • Shelly4Pro (untested)
  • Shelly Plug (untested)
  • Shelly PlugS (untested)
  • Shelly Bulb (untested)
  • Shelly H&T (untested)
  • Shelly Smoke (untested)
  • Shelly EM (untested)
  • Shelly flood (untested)


  • Shelly Sense (documentation is inaccurate, incomplete)
  • Shelly RGBW (documentation is incomplete)


this wrapper is best used in closed networks where other solutions are either not an option or not desired
give your shelly devices static IP adresses for best results


this project is licensed under the MIT License
feel free to do whatever you want with it

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ShellyPy, version 0.1.4
Filename, size File type Python version Upload date Hashes
Filename, size ShellyPy-0.1.4.tar.gz (5.0 kB) File type Source Python version None Upload date Hashes View
Filename, size ShellyPy-0.1.4-py3-none-any.whl (5.5 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page