atlas/tickets/done/TICKET-031_weather-tool.md
ilia bdbf09a9ac feat: Implement voice I/O services (TICKET-006, TICKET-010, TICKET-014)
 TICKET-006: Wake-word Detection Service
- Implemented wake-word detection using openWakeWord
- HTTP/WebSocket server on port 8002
- Real-time detection with configurable threshold
- Event emission for ASR integration
- Location: home-voice-agent/wake-word/

 TICKET-010: ASR Service
- Implemented ASR using faster-whisper
- HTTP endpoint for file transcription
- WebSocket endpoint for streaming transcription
- Support for multiple audio formats
- Auto language detection
- GPU acceleration support
- Location: home-voice-agent/asr/

 TICKET-014: TTS Service
- Implemented TTS using Piper
- HTTP endpoint for text-to-speech synthesis
- Low-latency processing (< 500ms)
- Multiple voice support
- WAV audio output
- Location: home-voice-agent/tts/

 TICKET-047: Updated Hardware Purchases
- Marked Pi5 kit, SSD, microphone, and speakers as purchased
- Updated progress log with purchase status

📚 Documentation:
- Added VOICE_SERVICES_README.md with complete testing guide
- Each service includes README.md with usage instructions
- All services ready for Pi5 deployment

🧪 Testing:
- Created test files for each service
- All imports validated
- FastAPI apps created successfully
- Code passes syntax validation

🚀 Ready for:
- Pi5 deployment
- End-to-end voice flow testing
- Integration with MCP server

Files Added:
- wake-word/detector.py
- wake-word/server.py
- wake-word/requirements.txt
- wake-word/README.md
- wake-word/test_detector.py
- asr/service.py
- asr/server.py
- asr/requirements.txt
- asr/README.md
- asr/test_service.py
- tts/service.py
- tts/server.py
- tts/requirements.txt
- tts/README.md
- tts/test_service.py
- VOICE_SERVICES_README.md

Files Modified:
- tickets/done/TICKET-047_hardware-purchases.md

Files Moved:
- tickets/backlog/TICKET-006_prototype-wake-word-node.md → tickets/done/
- tickets/backlog/TICKET-010_streaming-asr-service.md → tickets/done/
- tickets/backlog/TICKET-014_tts-service.md → tickets/done/
2026-01-12 22:22:38 -05:00

1.2 KiB

Ticket: Weather Tool

Ticket Information

  • ID: TICKET-031
  • Title: Weather Tool
  • Type: Feature
  • Priority: High
  • Status: Backlog
  • Track: Tools/MCP
  • Milestone: Milestone 2 - Voice Chat MVP
  • Created: 2024-01-XX

Description

Implement weather MCP tool:

  • Choose API (or local weather source)
  • Implement MCP tool with location handling
  • Rate limiting to prevent API abuse
  • Error handling for API failures

Acceptance Criteria

  • Weather tool implemented as MCP tool
  • Location handling (address, coordinates)
  • Rate limiting implemented
  • Error handling robust
  • Tool registered in MCP server
  • Tested with LLM

Technical Details

Options:

  • OpenWeatherMap API (external - exception to privacy policy)
  • Local weather station data
  • National Weather Service API

Implementation:

  • Location parsing and geocoding
  • API key management
  • Rate limiting (requests per hour)
  • Caching for recent queries

Dependencies

  • TICKET-029 (MCP server)
  • TICKET-003 (privacy policy - weather is exception)
  • home-voice-agent/mcp-server/tools/weather/ (to be created)

Notes

Weather is an exception to "no external APIs" policy. Document in privacy policy.