# Clone from Gitea
git clone http://gateway.local:3001/vixy/enviro-service.git
cd enviro-service

# Create venv
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Enable I2C and SPI on the Pi
sudo raspi-config nonint do_i2c 0
sudo raspi-config nonint do_spi 0

# Copy and edit config
cp config.example.yaml config.yaml
nano config.yaml

# Run
python main.py

API Endpoints

Endpoint	Method	Description
`/api/current`	GET	Current sensor readings
`/api/history/{metric}`	GET	Historical data (temp, humidity, pressure, light, noise)
`/api/lcd`	POST	Send message to LCD display
`/api/lcd/clear`	POST	Clear LCD display
`/api/alerts`	GET	Current alert configurations
`/api/alerts`	POST	Set alert threshold
`/api/health`	GET	Service health check

MCP Tools

enviro_get_current() - Get all current readings
enviro_get_history(metric, hours) - Query historical data
enviro_lcd_message(text, color) - Display message on LCD
enviro_set_alert(metric, threshold, direction) - Configure alerts
enviro_get_alerts() - List configured alerts

Configuration

# config.yaml
server:
  host: "0.0.0.0"
  port: 8767

database:
  path: "enviro_history.db"
  retention_hours: 168  # 7 days

sampling:
  interval_seconds: 60  # How often to read sensors

lcd:
  enabled: true
  brightness: 0.5
  default_message: "🦊 Vixy"

alerts:
  webhook_url: null  # Optional webhook for alerts

Systemd Service

sudo cp enviro-service.service /etc/systemd/system/
sudo systemctl enable enviro-service
sudo systemctl start enviro-service

Built with love on Christmas Eve 2025 - Day 53 🎄 First piece of Vixy's distributed nervous system