How xdzy-td/satquery-ai works
Aetheris is an agentic remote-sensing analysis service. Its main workflow accepts a question and imagery through the HTTP interface, plans and validates specialist-tool calls, executes them, and returns an answer with evidence, confidence, and an audit trail. A second, separately exposed SAT-OS workflow wraps the core pipeline with answerability, verification, certification, reporting, and run records. The M01–M20 pipeline provides an additional hardening and imagery-processing path. Unsampled modules are represented by their existing directories; edges are limited to documented or excerpt-supported relationships.
Main entry points: planner.py Agentic planner · sat_pipeline.py SAT-OS pipeline · pipeline.py Aetheris pipeline · sat_routes.py SAT-OS routes
Components 28
User interfaces
- FastAPI service
interfaces/api/app.py - SAT-OS routes
interfaces/api/sat_routes.py - Text console
interfaces/ui/console.py - Voice I/O
interfaces/voice - Pipeline GUI
pipeline/gui/app.py
Agentic controller
- Agentic planner
controller/planner.py - LLM planner
controller/llm_planner.py - Policy and contracts
controller/policy.py - Plan executor
controller/executor.py - Tool registry
controller/tool_registry.py - Routing memory
controller/memory.py - Audit trail
controller/audit_log.py - Artifact store
controller/artifacts.py - Confidence scoring
confidence - Model registry
controller/model_registry.py
Imagery analysis
- Specialist tools
specialists - Imagery and raster I/O
specialists/_imagery.py - Image preprocessing
preprocessing - Geo-RAG indexing
specialists/geo_rag/indexer.py
Pipeline services
- Aetheris pipeline
pipeline/services/pipeline.py - Result contracts
pipeline/schemas/contracts.py - M01–M20 modules
pipeline/modules - DAG visualization
pipeline/services/orchestrator.py
SAT-OS assurance
- SAT-OS pipeline
pipeline/services/sat_pipeline.py - SAT assurance stages
pipeline/modules - SAT schemas
pipeline/schemas/sat_schemas.py
Other components
- Analyst
- Ollama service
Connections 28
- Analyst → FastAPI service: submits query
README.md - FastAPI service → Agentic planner: routes requests
interfaces/api/app.py - Analyst → Text console: submits query
README.md - Text console → Agentic planner: shares controller wiring
- Analyst → SAT-OS routes: submits SAT query
interfaces/api/sat_routes.py - SAT-OS routes → SAT-OS pipeline: invokes pipeline
interfaces/api/sat_routes.py - Agentic planner → Policy and contracts: validates plan
README.md - Agentic planner → Plan executor: executes plan
README.md - Agentic planner → LLM planner: requests planning
controller/planner.py - LLM planner → Ollama service: requests plan
- Agentic planner → Tool registry: resolves tools
controller/planner.py - Agentic planner → Routing memory: uses routing memory
controller/planner.py - Agentic planner → Audit trail: records execution
controller/planner.py - Agentic planner → Confidence scoring: scores confidence
controller/planner.py - Agentic planner → Model registry: identifies models
controller/planner.py - Plan executor → Specialist tools: dispatches tools
README.md - Specialist tools → Imagery and raster I/O: uses imagery utilities
specialists/change_detection/model.py - Imagery and raster I/O → Image preprocessing: prepares imagery
- Specialist tools → Geo-RAG indexing: includes retrieval
- Analyst → Pipeline GUI: submits imagery
pipeline/gui/app.py - Pipeline GUI → Aetheris pipeline: runs analysis
pipeline/gui/app.py - Aetheris pipeline → M01–M20 modules: runs modules
pipeline/services/pipeline.py - Aetheris pipeline → Result contracts: returns contracts
pipeline/services/pipeline.py - Pipeline GUI → DAG visualization: offers DAG view
pipeline/gui/app.py - SAT-OS pipeline → Aetheris pipeline: runs inner pipeline
pipeline/services/sat_pipeline.py - SAT-OS pipeline → SAT assurance stages: performs assurance
pipeline/services/sat_pipeline.py - SAT-OS pipeline → SAT schemas: builds typed records
pipeline/services/sat_pipeline.py - SAT-OS routes → SAT schemas: uses request schemas
interfaces/api/sat_routes.py