pyvesync
pyvesync is a library to manage Etekcity Devices, Cosori Air Fryers, and Levoit Air Purifiers run on the VeSync app.
Decision gist · record as of 2026-08-14
Yes. The library is actively maintained, has no known vulnerabilities, and low install friction. It is the standard way to programmatically control VeSync devices in Python. The async-first design and strong typing make it suitable for modern applications. Breaking changes in version 3.0+ require careful migration if upgrading, but the refactored API is more consistent and maintainable. Recommended for anyone building integrations with VeSync-compatible smart home devices.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.11 or later; aiohttp ClientSession lifecycle must be managed correctly to avoid unclosed session warnings.
- Low friction install with two runtime dependencies (aiohttp and mashumaro).
- Actively maintained with a recent release and no known vulnerabilities.
License · maintenance · safety
MIT (permissive) — MIT license permits commercial and private use with minimal restrictions; you must include a copy of the license and copyright notice in distributions.
last release 2026-04-16 (120 days) · last repo commit 2026-08-10 · 240 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 79,074 downloads/mo, #14,385 on PyPI
Alternatives
Verify before relying
pip install pyvesync
import asyncio
from pyvesync import VeSync
async def main():
async with VeSync("username", "password", country_code="US") as manager:
await manager.login()
await manager.get_devices()
await manager.update()
for outlet in manager.devices.outlets:
await outlet.turn_off()
asyncio.run(main())- Whether all VeSync device models listed in documentation are actually supported in version 3.4.2
- Rate limiting behavior and retry strategies when hitting VeSyncRateLimitError
- Timeout and connection resilience for long-running device management sessions
What it is and what it does
pyvesync is an async Python library for controlling VeSync-compatible smart home devices sold under brands like Etekcity, Levoit, and Cosori. It handles authentication, device discovery, and state management for outlets, switches, fans, air purifiers, humidifiers, bulbs, air fryers, and thermostats. The library uses aiohttp for non-blocking network I/O and mashumaro for serialization, making it suitable for integration into async applications and home automation frameworks.
Version 3.0+ introduced a major refactor with breaking changes: asynchronous-only operation, strong typing, standardized device APIs across product types, and custom exception handling. Devices are organized into typed collections (outlets, switches, fans, etc.) and expose common methods like update() and turn_off(). The library requires explicit error handling for network failures and API errors, and manages its own aiohttp session unless you provide one.
Use it for
- Build a home automation dashboard that monitors and controls multiple VeSync devices in real time using async/await.
- Integrate Levoit air purifiers or Cosori air fryers into a larger smart home system that needs device state polling and remote commands.
- Create scheduled automation rules that turn outlets on/off or adjust fan speeds based on time or sensor triggers.
- Monitor device state changes and log energy consumption or operational metrics from Etekcity outlets.
- Develop a voice assistant skill or webhook handler that accepts commands to control VeSync devices asynchronously.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The library is actively maintained, has no known vulnerabilities, and low install friction. It is the standard way to programmatically control VeSync devices in Python. The async-first design and strong typing make it suitable for modern applications. Breaking changes in version 3.0+ require careful migration if upgrading, but the refactored API is more consistent and maintainable. Recommended for anyone building integrations with VeSync-compatible smart home devices.
Install
pyvesync on PyPI
Before you install
Low friction install with two runtime dependencies (aiohttp and mashumaro). Actively maintained with a recent release and no known vulnerabilities. Requires Python 3.11 or later.
Requires Python 3.11 or later; aiohttp ClientSession lifecycle must be managed correctly to avoid unclosed session warnings.
License in practice
MIT license permits commercial and private use with minimal restrictions; you must include a copy of the license and copyright notice in distributions.
Quickstart
pip install pyvesync
import asyncio
from pyvesync import VeSync
async def main():
async with VeSync("username", "password", country_code="US") as manager:
await manager.login()
await manager.get_devices()
await manager.update()
for outlet in manager.devices.outlets:
await outlet.turn_off()
asyncio.run(main())Verify before relying
- Whether all VeSync device models listed in documentation are actually supported in version 3.4.2
- Rate limiting behavior and retry strategies when hitting VeSyncRateLimitError
- Timeout and connection resilience for long-running device management sessions
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.11 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagesaiohttpmashumaro |
| Maintenance | Actively maintained 120 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 79,074 / month, #14,385 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseNatural Language :: EnglishTopic :: Home Automation |
Evidence: pyvesync-3.4.2-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “vesync smart home control”
- pyvesyncAsynchronous Python library to discover, authenticate with, and…
- python-kasaControl TP-Link Kasa and Tapo smart home devices (plugs, switches,…
- pyswitchbeeA Python library for controlling SwitchBee smart home devices over…
Give your agent the search over MCP, or paste the wish link into any chat.
More Home Automation packages
Represents and manipulates IPv4, IPv6, MAC addresses and related network objects; supports CIDR notation, subnetting, set operations, IANA lookups, and DNS reverse generation.
Home Assistant is an open-source home automation platform that centralizes control of smart home devices and automations on a local server or Raspberry Pi, prioritizing local control and privacy over cloud dependency.
Defines finite state machines and statecharts with a declarative Python API, supporting flat states, compound hierarchies, parallel regions, history states, guards, and both sync and async callbacks.
Install it if you need to model workflows, control logic, or any system with discrete states and event-driven transitions — from simple state machines to complex…
A Python library for controlling BlueZ Bluetooth adapters on Linux via the Management API, supporting both synchronous and event-driven command patterns.
An async Python library for controlling and monitoring Homematic and HomematicIP devices through multiple backend systems (CCU3, OpenCCU, Homegear, CUxD, CCU-Jack) using XML-RPC and JSON-RPC protocols.
Install it if you need to control Homematic devices from Python; the only constraint is a requirement for Python 3.14 or later and network access to a compatible…
Provides base classes and utilities for Home Assistant integrations to proxy HTTP and WebSocket traffic through Home Assistant's web server.
Install only if you are building a custom Home Assistant integration; it is not useful as a standalone package.
See also pyemvue · pyswitchbee · bond-async · fjaraskupan · pyoverkiz · pydaikin · meross-iot · pywemo · plugp100 · epson-projector