How netalgupta/varuna works
VARUNA combines ARGO physical-ocean observations and CMLRE biodiversity information for ocean operations, analytics, alerts, and natural-language investigation. A typical query enters through the API, is decomposed into agent tasks, and its gathered evidence is checked before synthesis; the frontend presents the answer and operational views. The README also documents ingestion, forecasting, quality control, and spatial visualization. Some domain branches are supported by README descriptions and the file tree rather than sampled implementation excerpts, so their internal links are omitted.
Main entry points: orchestrator.py Agent DAG · aegis_engine.py AEGIS Evidence Check · CommandCenterView.tsx Operations Center · postgres.py PostGIS Store
Components 24
Data Ingestion
- ARGO Ingestion
backend/src/ingestion/pipeline.py - NetCDF Reader
backend/src/ingestion/netcdf_reader.py
Query and Agents
- FastAPI App
backend/src/api/app.py - API Routes
backend/src/api/routes.py - Agent DAG
backend/src/agents/orchestrator.py - SQL Agent
backend/src/agents/sql_gen_agent.py - Retrieval Agent
backend/src/agents/retrieval_agent.py - Biodiversity Agent
backend/src/agents/biodiversity_agent.py - Answer Synthesizer
backend/src/agents/synthesizer_agent.py
Evidence and Retrieval
- AEGIS Evidence Check
backend/src/aegis/aegis_engine.py - Evidence Ledger
backend/src/aegis/evidence_ledger.py - Claim Extraction
backend/src/aegis/claim_extractor.py - Claim Firewall
backend/src/aegis/claim_firewall.py - RAG Chain
backend/src/chains/rag_chain.py
Data and Models
- PostGIS Store
backend/src/database/postgres.py - Vector Store
backend/src/database/qdrant.py - Forecast and QC
backend/src/ml
Ocean Operations UI
- Operations Center
frontend/src/features/command-center/CommandCenterView.tsx - Ocean Maps
frontend/src/features/ocean-map/VarunaMap.tsx - Ocean Analytics
frontend/src/features/cross-domain/AnalyticsView.tsx - Biodiversity View
frontend/src/features/biodiversity/BiodiversityView.tsx - Early Warnings
frontend/src/features/early-warning/ForecastsView.tsx - Dataset Export
frontend/src/features/datasets/DatasetsView.tsx
Other components
- Ocean User
Connections 23
- Ocean User → Operations Center: uses
README.md - Operations Center → API Routes: queries
- FastAPI App → API Routes: registers
backend/src/api/app.py - API Routes → Agent DAG: invokes
backend/src/api/routes.py - Agent DAG → SQL Agent: dispatches
backend/src/agents/orchestrator.py - Agent DAG → Retrieval Agent: dispatches
backend/src/agents/orchestrator.py - Agent DAG → Biodiversity Agent: dispatches
backend/src/agents/orchestrator.py - Agent DAG → AEGIS Evidence Check: verifies evidence
backend/src/agents/orchestrator.py - Agent DAG → Answer Synthesizer: synthesizes
backend/src/agents/orchestrator.py - AEGIS Evidence Check → Evidence Ledger: builds
backend/src/aegis/aegis_engine.py - AEGIS Evidence Check → Claim Extraction: extracts claims
backend/src/aegis/aegis_engine.py - AEGIS Evidence Check → Claim Firewall: checks claims
backend/src/aegis/aegis_engine.py - ARGO Ingestion → NetCDF Reader: reads profiles
backend/src/ingestion/pipeline.py - ARGO Ingestion → PostGIS Store: loads observations
backend/src/ingestion/pipeline.py - SQL Agent → PostGIS Store: queries
- Retrieval Agent → RAG Chain: retrieves context
- RAG Chain → Vector Store: searches vectors
- PostGIS Store → Ocean Analytics: supplies observations
- Biodiversity Agent → Biodiversity View: supports exploration
- Forecast and QC → Early Warnings: supports forecasts
- PostGIS Store → Ocean Maps: supplies ocean data
- Operations Center → Early Warnings: presents warnings
README.md - Operations Center → Dataset Export: offers exports
README.md