A Python 3 library for programmatically accessing Anova WiFi-enabled sous vide cookers through the Anova API.
A Python 3 library for programmatically accessing WiFi-enabled Anova sous vide cookers through the Anova API.
NOTE: This library uses the Anova REST API and has been tested with the Anova Precision Cooker Pro. Make sure your Anova cooker supports WiFi and is already connected.
pyanova-api does not support communication over Bluetooth.
pyanova-api can be installed from either PyPi or can be installed manually by cloning the GitHub repository.
pip install pyanova-api
First, clone the GitHub repository:
git clone https://github.com/ammarzuberi/pyanova-api.git
Enter the newly created
pyanova-api directory and run:
pip install .
This should install
pyanova-api on your system. You can use it in your own Python scripts like so:
You will need your cooker ID to use
pyanova-api. This can be easily found in the Anova app when your cooker is connected to WiFi.
On the profile page, click the settings button (top right of the page, cog icon) and choose "Cooker Details."
To get started, first import the
AnovaCooker class from
from anova import AnovaCooker cooker = AnovaCooker('your device ID goes here')
The code above initializes the cooker into the
cooker variable. Simply initializing the cooker object with cooker state does not require authentication with the Anova API, and as such can be used to obtain information about any cooker as long as you have the cooker ID.
Setting cooker state
There are four state variables that can be modified and pushed to the cooker:
- Cooker on/off (
- Cook time (in seconds,
- Target temperature (in Celcius,
- Temperature display unit (
Before setting the cooker state, you must authenticate with the Anova API. In the current version of
pyanova-api, only email/password authentication is supported. You can authenticate yourself in
pyanova-api like so:
cooker.authenticate('your email address goes here', 'your password goes here')
Once you're authenticated, starting a new cook that will last 2 hours at 55 degrees Celcius will look like this:
cooker.cook = True cooker.cook_time = 60 * 60 * 2 # 2 hours in seconds cooker.target_temp = 55.0 cooker.save()
cooker.save() method calls the Anova API and starts the cook.
The cooker's display unit is the unit used to display temperature in the Anova app and on the cooker itself. This can be changed like so:
cooker.temp_display_unit = 'F' cooker.save()
NOTE: The target temperature is always in Celcius. Changing the display temperature does not change this.
Getting cooker state
In addition to the four state variables that can be modified, there are multiple other state variables that can be accessed via the API but are read-only.
Before checking the values of state variables, always make sure they are the most current by calling
update_state() after modifying one of the mutable variables but before calling
save() will cause the changes to be overwritten with the values from the API.
All the available state variables are:
||str||The status of the current job, for example,
||int||The number of seconds remaining in the job.|
||float||The heater's percentage duty cycle.|
||float||The motor's percentage duty cycle.|
||bool||The cooker's WiFi connection status.|
||str||The SSID of the network the cooker is connected to.|
||bool||Is the device is safe to operate?|
||bool||Is there a water leak?|
||bool||Is the water level too low for operation?|
||bool||Is the water level low?|
||float||The heater's temperature in Celcius.|
||float||The triac's (like a relay) temperature in Celcius.|
||float||The water's temperature in Celcius.|
These state variables can be accessed like so:
cooker.update_state() wifi_ssid = cooker.wifi_ssid water_temp = cooker.water_temp
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size pyanova_api-0.0.1-py3-none-any.whl (5.9 kB)||File type Wheel||Python version py3||Upload date||Hashes View hashes|
|Filename, size pyanova-api-0.0.1.tar.gz (4.8 kB)||File type Source||Python version None||Upload date||Hashes View hashes|
Hashes for pyanova_api-0.0.1-py3-none-any.whl