anova-oven

Anova Oven & Precision Cooker Control

Control Anova WiFi devices including Precision Ovens (APO) and Precision Cookers (APC) via WebSocket API.

Prerequisites

1. Personal Access Token from Anova app

   • Download Anova Oven app (iOS/Android)
   • Go to: More → Developer → Personal Access Tokens
   • Create token (starts with anova-)
   • Store in ~/.config/anova/token

2. Python dependencies

   pip3 install websockets
   

3. Device Setup

   • Anova device connected to WiFi
   • Paired with your Anova account

Installation

# Install Python dependency
pip3 install websockets

# Store your token
mkdir -p ~/.config/anova
echo "anova-YOUR_TOKEN_HERE" > ~/.config/anova/token
chmod 600 ~/.config/anova/token

Usage

List Devices

python3 scripts/anova.py list

Basic Cooking

# Simple cook at 350°F for 30 minutes
python3 scripts/anova.py cook --temp 350 --duration 30

# Cook at 175°C for 45 minutes
python3 scripts/anova.py cook --temp 175 --unit C --duration 45

Advanced Controls

Custom Elements:

# Rear element only (low-temp slow cook)
python3 scripts/anova.py cook --temp 225 --elements rear --duration 180

# Bottom + rear (standard roasting)
python3 scripts/anova.py cook --temp 375 --elements bottom,rear --duration 45

# All elements (maximum heat)
python3 scripts/anova.py cook --temp 450 --elements top,bottom,rear --duration 20

Custom Fan Speed:

# Low fan (gentle cooking)
python3 scripts/anova.py cook --temp 250 --fan-speed 25 --duration 120

# High fan (fast heat circulation)
python3 scripts/anova.py cook --temp 400 --fan-speed 100 --duration 30

Probe Cooking:

# Cook to internal temperature (not time-based)
python3 scripts/anova.py cook --temp 350 --probe-temp 165

# Low-temp probe cook
python3 scripts/anova.py cook --temp 225 --elements rear --fan-speed 25 --probe-temp 135

Combined Advanced Settings:

# Precision low-temp cook
python3 scripts/anova.py cook --temp 225 --elements rear --fan-speed 25 --duration 180

# High-heat sear
python3 scripts/anova.py cook --temp 500 --elements top,bottom,rear --fan-speed 100 --duration 5

Stop Cooking

python3 scripts/anova.py stop

Monitor (Real-time Stream)

python3 scripts/anova.py monitor --monitor-duration 60

Natural Language Examples

Agent prompts:

• "Preheat the oven to 375°F for roasting"
• "Start sous vide at 135°F for 2 hours"
• "What's the current oven temperature?"
• "Stop cooking"
• "Steam vegetables at 212°F for 15 minutes"

Features

Anova Precision Oven (APO)

• Sous vide cooking (wet bulb mode)
• Roasting (dry bulb mode)
• Steam cooking with humidity control
• Temperature control (C/F)
• Real-time status monitoring
• Telemetry export

Anova Precision Cooker (APC)

• Sous vide cooking
• Temperature control
• Timer management
• Real-time status

API Reference

WebSocket Endpoint: Via Anova cloud service Authentication: Personal Access Token (Bearer token) Protocol: WebSocket with JSON messages

Configuration

Token file: ~/.config/anova/token Default device: First device found (or specify with --device-id)

Troubleshooting

"No token found":

echo "anova-YOUR_TOKEN" > ~/.config/anova/token

"No devices found":

• Check device is online in Anova app
• Verify WiFi connection
• Generate new token

"Connection failed":

• Check internet connection
• Verify token is valid
• Ensure device is paired with account

Safety Notes

• Always verify temperature before starting long cooks
• Use timers to prevent overcooking
• Monitor remotely but check in-person for safety
• Default timeout: 4 hours max

References

• Anova Developer Portal
• GitHub: anova-wifi-device-controller