How elsayedelmandoh/spaceeye-geoai works
SpaceEye ranks coded R7 compounds for committee inspections and presents the results through a Streamlit observatory and hybrid RAG chatbot. The dashboard workflow moves from prepared data to indicator and priority views, then to inspection planning and exports; separate capabilities cover synthetic what-if analysis, early-warning evaluation, imagery context, and guarded inspection reports. The chatbot routes questions, retrieves structured and document evidence, and produces sourced answers, using Gemini within a budget or local generation. Several pipeline and data-preparation links are documented but their implementation was not sampled, so those edges are omitted.
Main entry points: app.py Dashboard UI · service.py Answer Service · hybrid.py Hybrid Retrieval · setup_review.py Prepared Release
Components 23
Priority Observatory
- Dashboard UI
app.py - Priority Insights
src/dashboard/insights.py - Visit Planning
src/dashboard/ops_visits.py - Cycle CSV Export
src/dashboard/exports.py - Prepared Release
src/pipeline/setup_review.py - Data Paths and Config
src/pipeline/common.py
Analysis and Scenarios
- Warning Features
src/analysis/ew_features.py - Warning Evaluation
src/analysis/ew_eval.py - What-if Scenarios
src/generator/scenarios.py
Evidence and Reporting
- Satellite Imagery
src/pipeline/imagery_earth_engine.py - Inspection Context
src/inference/inspection_file.py - Guarded Reports
src/inference/inspection_report.py
RAG Chatbot
- Chat Interface
chatbot/frontend/app.js - Chat API
chatbot/app/api/main.py - Answer Service
chatbot/app/generation/service.py - Intent Router
chatbot/app/retrieval/router.py - Hybrid Retrieval
chatbot/app/retrieval/hybrid.py - Structured Facts
chatbot/app/retrieval/structured.py - Vector Search
chatbot/app/retrieval/vector_store.py - Local Answer Builder
chatbot/app/generation/answer_builder.py - Gemini Generation
chatbot/app/generation/gemini_client.py
Other components
- Inspection Committee
- Dashboard Chat User
Connections 20
- Inspection Committee → Dashboard UI: views priorities
README.md - Dashboard UI → Priority Insights: builds views
app.py - Dashboard UI → Visit Planning: opens form
app.py - Dashboard UI → Cycle CSV Export: exports cycle
app.py - Dashboard UI → Prepared Release: reads release
- Prepared Release → Data Paths and Config: uses paths
src/pipeline/setup_review.py - Inspection Committee → Satellite Imagery: reviews context
- Warning Features → Warning Evaluation: supplies features
src/analysis/ew_eval.py - Inspection Committee → What-if Scenarios: explores what-if
README.md - Inspection Committee → Inspection Context: uses contexts
README.md - Inspection Context → Guarded Reports: renders report
src/inference/inspection_report.py - Dashboard Chat User → Chat Interface: asks question
README.md - Chat Interface → Chat API: sends question
- Chat API → Answer Service: processes question
chatbot/app/api/main.py - Answer Service → Hybrid Retrieval: retrieves evidence
chatbot/app/generation/service.py - Hybrid Retrieval → Intent Router: routes query
chatbot/app/retrieval/hybrid.py - Hybrid Retrieval → Structured Facts: reads facts
chatbot/app/retrieval/hybrid.py - Hybrid Retrieval → Vector Search: searches documents
chatbot/app/retrieval/hybrid.py - Answer Service → Local Answer Builder: builds local answer
chatbot/app/generation/service.py - Answer Service → Gemini Generation: generates answer
chatbot/app/generation/service.py