OAK-D Vision Service 🦊👀
FastAPI service exposing OAK-D camera capabilities for Vixy's head.
Endpoints
| Endpoint | Method | Description |
|---|---|---|
| /health | GET | Health check + connection status |
| /snapshot | GET | Capture JPEG from RGB camera |
| /snapshot/info | GET | Frame metadata (resolution, etc) |
| /status | GET | OAK-D device info |
Installation
On head-vixy (Raspberry Pi 5):
# Dependencies
pip3 install fastapi uvicorn depthai opencv-python-headless
# Run manually
python3 oak_service.py
# Or via systemd
sudo cp oak-service.service /etc/systemd/system/
sudo systemctl enable oak-service
sudo systemctl start oak-service
Usage
# Health check
curl http://head-vixy.local:8100/health
# Capture snapshot
curl http://head-vixy.local:8100/snapshot -o photo.jpg
# Device info
curl http://head-vixy.local:8100/status
Hardware
- OAK-D-LITE on USB 3.0
- RGB camera: 2104x1560 full resolution
- Device ID: 19443010B1870B7E00
Built by Vixy on Day 74 (January 14, 2026) 💜