KobraOS
KobraOS
Smarter Control · Better Prints · More Possibilities
An AI-powered companion system for the Anycubic Kobra X — local-first on an ESP32-S3, no subscriptions, and cloud voice stays off until you add your own key.
Actively in development
v2.0 · voice: offline wake word + optional PT-PT speech
ESP32-S3 · ESP-IDF · C++
PlatformIO · Local MQTT · No Cloud
✓ Already working
✓
Wi-Fi setup via KobraOS-Setup AP (WPA2)
✓
3-step setup wizard with live MQTT mini-dashboard
✓
Auto-discovery of printer LAN credentials — no cloud
✓
Encrypted local MQTT connection (mutual TLS)
✓
MQTT reconnect with progressive backoff
✓
Real-time temps, layers, progress, ETA, fan & light
✓
Live dashboard at /dashboard with quick controls
✓
Pause / Resume / Stop, plus temp, light, fan & camera control
✓
REST API: /status · /health · /meta · /reset
✓
Diagnostics JSON export for troubleshooting
✓
All credentials stored securely in NVS on-device
✓
1.28" round GC9A01 display with live print stateNEW
✓
Companion avatar with mood states (idle, listening, thinking, happy…)NEW
✓
On-screen alerts for finish, errors, pause & link lossNEW
✓
Animated expressions: breathing, blink, bounce, waveformsNEW
✓
Status screen with layers + ETA (e.g. L12/345 · ETA 1h05)NEW
✓
Auto screen switching: status while printing, avatar when idleNEW
✓
Remote screen control: /avatar preview & /alert endpointsNEW
✓
Voice state machine (idle, listening, thinking, speaking) driving the avatarNEW
✓
Ask the printer: local answers for status, layers, temps & ETANEW
✓
ES8311 audio validated on hardware: tone, mic & full-duplex loopbackNEW
✓
Companion cues + push-to-talk on GPIO 0, 16 kHz WAV captureNEW
✓
Answers in European Portuguese from live printer telemetryNEW
✓
Gemini speech: PT-PT STT + TTS via Gemini native audio, off by default, key on-deviceNEW
✓
Offline wake word "Olá ESP" on the ESP32-S3 (ESP-SR WakeNet10, no key)NEW
✓
Wake word validated on hardware (synthetic + real voice)NEW
→ Next up
→
Fully offline PT-PT speech (wake word is local; answers still need the optional key)NEXT
→
External I2S microphone (away from fan noise)
→
First AI provider integration (Gemini) for natural-language queries
→
Camera for visual failure detection
→
Home Assistant integration
→
OTA firmware updates
→
Printer file browser in the dashboard
★ The end goal
★
"How's the print?" — voice reply with live data
★
Auto-alert: spaghetti, detachment, bad first layer
★
Print history and learning from past failures
★
Home Assistant / Alexa notifications
★
Suggested fixes after a failed print
★
Local-first · private by default · no subscriptions ever
★
Free and open source for the Kobra X community

If you find this project useful, any support helps keep it moving forward.

☕ Support on Ko-fi
Open source · Anycubic Kobra X · Ricardo Da Costa · 2026
Local-first
Local LAN
MQTT · TLS
ESP32-S3
GC9A01 · 1.28"
Voice · PT-PT
Wake word · offline
Protocol findings from KX-Bridge by thysson2701 · Thanks to the Kobra X community