How kd4r/satquery works
SatQuery AI is a natural-language satellite intelligence platform. A user submits a mission query in the web app; the agent plans the analysis, arbitrates sensors, searches EO catalogues, obtains observations, calls inference, and produces confidence and evidence for a synthesized result. Mission/AOI lifecycle and asynchronous geospatial processing are adjacent product capabilities. The sampled orchestrator and service excerpts support the main analysis links; unsampled gateway and mission wiring is left unspecified.
Main entry points: orchestrator.py Run orchestrator · api/implementation.py Agent API · gateway/implementation.py API gateway · Dashboard.tsx Web dashboard
Components 26
Web experience
- Web dashboard
apps/web/components/Dashboard.tsx - Query console
apps/web/components/QueryConsole.tsx - Analysis views
apps/web/components/EvidencePanel.tsx
Mission and access
- API gateway
services/gateway/implementation.py - Mission API
services/mission/implementation.py - Mission database
services/mission/database.py
Agent analysis
- Agent API
services/agent/app/api/implementation.py - Run orchestrator
services/agent/graph/orchestrator.py - Intent extraction
services/agent/nodes/intent_extractor.py - Sensor arbitration
services/agent/nodes/sensor_arbitrator.py - Acquisition loop
services/agent/graph/acquisition_loop.py - Tool execution
services/agent/tools/executor.py - STAC search tool
services/agent/tools/stac_search.py - Confidence gate
services/agent/nodes/confidence_gate.py - Evidence graph
services/agent/evidence/graph_builder.py - Result synthesis
services/agent/nodes/synthesizer.py
Earth observation
- Observation search
services/eo-data/search.py - EO providers
packages/providers
Inference and geospatial
- Inference API
services/inference/routers/inference.py - Analysis service
services/inference/service.py - Water analysis
ml/pipeline - Geo processing API
services/geo/api.py - Geo job worker
services/geo/worker.py
Other components
- Analyst
- Redis broker/cache
- Satellite catalogues
Connections 25
- Analyst → Web dashboard: uses
- Web dashboard → Query console: shows
- Query console → API gateway: submits query
- API gateway → Agent API: routes request
- API gateway → Mission API: routes lifecycle
- Mission API → Mission database: reads/writes
- Agent API → Run orchestrator: starts run
- Run orchestrator → Intent extraction: extracts intent
- Run orchestrator → Sensor arbitration: arbitrates sensors
- Run orchestrator → Acquisition loop: acquires data
- Acquisition loop → Tool execution: executes tools
- Tool execution → STAC search tool: dispatches
- STAC search tool → Observation search: searches observations
- Observation search → EO providers: queries provider
- EO providers → Satellite catalogues: searches
- Run orchestrator → Inference API: requests analysis
- Inference API → Analysis service: runs analysis
- Analysis service → Water analysis: runs method
- Run orchestrator → Confidence gate: evaluates confidence
- Run orchestrator → Evidence graph: builds evidence
- Run orchestrator → Result synthesis: synthesizes outcome
- Result synthesis → Agent API: returns result
- Agent API → Analysis views: returns analysis
- Geo processing API → Geo job worker: dispatches job
- Geo job worker → Redis broker/cache: tracks idempotency