How kspavitra/fishermen-ai works
Fishermen-AI is a mobile-first, voice-oriented fishing advisory app for coastal Karnataka. The main workflow is a fisher’s voice or text query reaching the Flask decision endpoint, which fetches weather and evaluates marine safety before returning a GO/CAUTION/DO NOT GO-style advisory. The README also describes market, seasonal fishing, safety, emergency, trip-management, and offline capabilities. The frontend is represented by its existing index.html path; its implementation was not sampled, so its internal feature wiring is not shown.
Main entry points: index.html Voice and Text App · app.py Decision API · weather_service.py Weather Service · decision_engine.py Marine Decision Engine
Components 17
Fisher App
- Voice and Text App
frontend/index.html
Advisory Backend
- Decision API
backend/app.py - Weather and Forecast API
backend/app.py - Weather Service
backend/weather_service.py - Marine Decision Engine
backend/decision_engine.py
Fishing Information
- Tide and Calendar
backend/app.py - Best Fishing Times
backend/app.py - Fish Market Prices
backend/app.py - Seasonal Fish Guide
backend/app.py - Fish Photo Identification
backend/app.py - Government Schemes
backend/app.py
Safety and Offline
- Emergency and Location Sharing
frontend/index.html - Trip History and Reports
frontend/index.html - Dashboard and Fuel Calculator
frontend/index.html - Offline Support
frontend/sw.js
Other components
- Fisher
- OpenWeatherMap
Connections 19
- Fisher → Voice and Text App: asks for advice
README.md - Voice and Text App → Decision API: submits query
README.md - Decision API → Weather Service: fetches weather
backend/app.py - Weather Service → OpenWeatherMap: requests conditions
backend/weather_service.py - Weather Service → Decision API: returns weather
backend/app.py - Decision API → Marine Decision Engine: evaluates conditions
backend/app.py - Decision API → Voice and Text App: returns advisory
README.md - Voice and Text App → Weather and Forecast API: requests forecasts
- Weather and Forecast API → Weather Service: gets weather data
backend/app.py - Voice and Text App → Tide and Calendar: views guidance
- Voice and Text App → Best Fishing Times: views time windows
- Voice and Text App → Fish Market Prices: checks prices
- Voice and Text App → Seasonal Fish Guide: views predictions
- Voice and Text App → Fish Photo Identification: identifies catch
- Voice and Text App → Government Schemes: views schemes
- Voice and Text App → Emergency and Location Sharing: uses emergency tools
- Voice and Text App → Trip History and Reports: manages trips
- Voice and Text App → Dashboard and Fuel Calculator: views trip metrics
- Voice and Text App → Offline Support: uses cached data