How rachkb/fire-watch works
FireWatch is a Streamlit decision-support app for classifying uploaded fire/smoke images, showing confidence, risk, and optional Grad-CAM explanations, then saving submissions for administrator review. The main workflow runs from upload through inference and pending storage; only approved submissions appear in public history. Admins can authenticate, moderate submissions, and view analytics. The graph reflects README and SOURCE INDEX relationships; some implementation details are unsampled, so uncertain links are omitted.
Main entry points: data_access.py UI data adapter · session.py Database sessions · upload_page.py Image upload · submission_service.py Submission service
Components 27
Streamlit UI
- Page router
app.py - Home page
firewatch/ui/home_page.py - Image upload
firewatch/ui/upload_page.py - Approved history
firewatch/ui/history_page.py - Admin login page
firewatch/ui/admin_login_page.py - Moderation page
firewatch/ui/admin_moderation_page.py - Analytics page
firewatch/ui/admin_analytics_page.py - Shared UI components
firewatch/ui/components.py - UI data adapter
firewatch/ui/data_access.py
Image analysis
- Image preprocessing
firewatch/inference/preprocess.py - Classifier and predictor
firewatch/inference/predictor.py - Risk assessment
firewatch/inference/risk.py - Grad-CAM heatmaps
firewatch/inference/heatmap.py - Grad-CAM computation
firewatch/inference/gradcam.py - Shared thresholds
firewatch/config.py
Application services
- Submission service
firewatch/services/submission_service.py - Moderation service
firewatch/services/moderation_service.py - Analytics service
firewatch/services/analytics_service.py - Submission row mapper
firewatch/services/rows.py
Persistence
- Application records
firewatch/db/models.py - Database sessions
firewatch/db/session.py - Image storage adapter
firewatch/db/storage.py
Admin identity
- Authentication service
firewatch/auth/service.py
Other components
- Public user
- Administrator
- SQLite / PostgreSQL
- Local / Supabase storage
Connections 48
- Public user → Home page: opens
README.md - Administrator → Admin login page: logs in
README.md - Page router → Home page: routes to
app.py - Page router → Admin login page: routes to
app.py - Page router → Moderation page: routes to
app.py - Page router → Analytics page: routes to
app.py - Home page → Image upload: renders
firewatch/ui/home_page.py - Home page → Approved history: renders
firewatch/ui/home_page.py - Home page → Shared UI components: uses
firewatch/ui/home_page.py - Image upload → Image preprocessing: analyzes image
README.md - Image upload → Classifier and predictor: requests prediction
firewatch/ui/upload_page.py - Image upload → Grad-CAM heatmaps: requests explanation
README.md - Image upload → UI data adapter: saves result
firewatch/ui/upload_page.py - Image upload → Shared UI components: renders result
firewatch/ui/upload_page.py - Approved history → UI data adapter: loads approved items
firewatch/ui/history_page.py - Approved history → Shared UI components: uses
firewatch/ui/history_page.py - Admin login page → UI data adapter: authenticates
firewatch/ui/admin_login_page.py - Moderation page → UI data adapter: requests review actions
firewatch/ui/admin_moderation_page.py - Moderation page → Shared UI components: uses
firewatch/ui/admin_moderation_page.py - Analytics page → UI data adapter: loads analytics
firewatch/ui/admin_analytics_page.py - Analytics page → Shared UI components: uses
firewatch/ui/admin_analytics_page.py - UI data adapter → Authentication service: delegates login
firewatch/ui/data_access.py - UI data adapter → Submission service: delegates submissions
firewatch/ui/data_access.py - UI data adapter → Moderation service: delegates moderation
firewatch/ui/data_access.py - UI data adapter → Analytics service: delegates analytics
firewatch/ui/data_access.py - Classifier and predictor → Image preprocessing: preprocesses with
firewatch/inference/predictor.py - Classifier and predictor → Risk assessment: derives risk
firewatch/inference/predictor.py - Grad-CAM heatmaps → Grad-CAM computation: computes with
firewatch/inference/heatmap.py - Grad-CAM heatmaps → Image preprocessing: uses
firewatch/inference/heatmap.py - Risk assessment → Shared thresholds: reads thresholds
firewatch/inference/risk.py - Image preprocessing → Shared thresholds: reads input settings
firewatch/inference/preprocess.py - Submission service → Image storage adapter: stores image
firewatch/services/submission_service.py - Submission service → Application records: creates submission
firewatch/services/submission_service.py - Submission service → Database sessions: opens session
firewatch/services/submission_service.py - Submission service → Submission row mapper: formats listings
firewatch/services/submission_service.py - Moderation service → Image storage adapter: deletes image
firewatch/services/moderation_service.py - Moderation service → Application records: updates records
firewatch/services/moderation_service.py - Moderation service → Database sessions: opens session
firewatch/services/moderation_service.py - Moderation service → Submission row mapper: formats listings
firewatch/services/moderation_service.py - Analytics service → Application records: queries records
firewatch/services/analytics_service.py - Analytics service → Database sessions: opens session
firewatch/services/analytics_service.py - Submission row mapper → Image storage adapter: loads thumbnails
firewatch/services/rows.py - Authentication service → Application records: queries admin
firewatch/auth/service.py - Authentication service → Database sessions: opens session
firewatch/auth/service.py - Database sessions → Application records: creates schema
firewatch/db/session.py - Database sessions → SQLite / PostgreSQL: connects to
README.md - Image storage adapter → Database sessions: reads configuration
firewatch/db/storage.py - Image storage adapter → Local / Supabase storage: stores and retrieves
firewatch/db/storage.py