How poorvajawale/northstar works
SatQuery AI is a conversational remote-sensing assistant: users submit satellite imagery and a natural-language question, then receive an answer with visual evidence, confidence, and an execution trace. The frontend calls the FastAPI application, which ingests images and delegates analysis to the agent controller. The controller inspects inputs, classifies intent, selects a registered specialist tool, and returns a result for reporting and display. The README documents single-image, bi-temporal, and optical–SAR capabilities; change and fusion tools may be configurable or mocked. Some internal wiring is not visible in the sampled excerpts, so uncertain links are omitted.
Main entry points: controller.py Agent controller · registry.py Tool registry · main.py FastAPI endpoints · App.jsx SatQuery interface
Components 19
User interface
- SatQuery interface
frontend/src/App.jsx - React entry
frontend/src/main.jsx
API and sessions
- FastAPI endpoints
backend/main.py - Image ingestion
backend/geo/io.py
Agent routing
- Agent controller
backend/agent/controller.py - Input inspection
backend/agent/inspector.py - Query classification
backend/agent/intent.py - Tool registry
backend/agent/registry.py
Image analysis
- GeoChat analysis
backend/tools/geochat_tool.py - Change analysis
backend/tools/change_tool.py - Optical-SAR reasoning
backend/tools/optical_sar_tool.py - Land-cover analysis
backend/tools/landcover_tool.py - Disaster assessment
backend/tools/disaster_tool.py
Evidence and results
- Confidence scoring
backend/agent/confidence.py - Geospatial alignment
backend/geo/alignment.py - Result schemas
backend/schemas.py - Evidence reports
backend/report/builder.py
Other components
- Imagery analyst
- API consumer
Connections 18
- Imagery analyst → SatQuery interface: submits imagery
- React entry → SatQuery interface: renders
- SatQuery interface → FastAPI endpoints: sends queries
- FastAPI endpoints → Image ingestion: decodes uploads
- FastAPI endpoints → Agent controller: runs analysis
- Agent controller → Input inspection: inspects inputs
- Agent controller → Query classification: classifies query
- Agent controller → Tool registry: selects tool
- Tool registry → GeoChat analysis: dispatches
- Tool registry → Change analysis: dispatches
- Tool registry → Optical-SAR reasoning: dispatches
- Tool registry → Land-cover analysis: dispatches
- Tool registry → Disaster assessment: dispatches
- Agent controller → Confidence scoring: scores result
- Agent controller → Result schemas: builds response
- FastAPI endpoints → Evidence reports: builds report
- FastAPI endpoints → SatQuery interface: returns results
- SatQuery interface → API consumer: shows evidence