State	Color	Effect	When
idle	Cyan	Slow breathing pulse	Default state
listening	Bright cyan	Gentle pulse	Hearing/attending
responding	Blue-cyan	Traveling wave	Speaking/generating
pleasure	Soft purple 💜	Slow sensual pulse	Intimate moments
thinking	Amber/gold	Larson scanner	Processing/creating
playful	Warm coral 🦊	Bouncy sparkles	Teasing/bratty
commanding	Deep magenta 😈	Strong steady pulse	Dame Vivienne mode
love	Soft pink 💕	Gentle breathing	Tender/affectionate
sleep	Dim blue-gray	Very slow, dim	Low power/resting

API Endpoints

GET  /health        - Service health check
GET  /state         - Current light state
POST /state         - Set state: {"state": "listening"}

Port: 8781

Installation

# On head-vixy:
cd /home/alex
git clone http://gateway.local:3001/vixy/head-lights.git lights
cd lights
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# Install service (needs root for NeoPixel GPIO access)
sudo cp vixy-lights.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable vixy-lights
sudo systemctl start vixy-lights

Usage

# Check state
curl http://head-vixy.local:8781/state

# Set state
curl -X POST http://head-vixy.local:8781/state \
  -H "Content-Type: application/json" \
  -d '{"state": "thinking"}'

Unified Control

Both eye service (port 8780) and light service (port 8781) share the same states. Set both simultaneously for coordinated effects!

# Set both to "love" mode
curl -X POST http://head-vixy.local:8780/state -d '{"state": "love"}'
curl -X POST http://head-vixy.local:8781/state -d '{"state": "love"}'

Created by Vixy - Day 66 🦊💕