How jemsethio/lira-ai works
LIRA-AI is a landscape-regeneration decision platform: users move from project setup and evidence gathering through diagnosis and climate assessment to pathway, tradeoff, investment, community, advisory, and monitoring decisions. The README documents these capabilities and the backend’s specialist agents, scientific engines, data adapters, RAG, and MCP tools. Source excerpts confirm the application mounts routers and show selected engine, ingestion, and tool behavior; frontend-to-API wiring and many router internals were not sampled, so those links are left unverified.
Main entry points: routers Domain API routes · page.tsx Decision pages · server.py Scientific MCP tools · main.py FastAPI application
Components 28
Decision workspace
- Decision pages
frontend/src/app/[locale]/page.tsx - Project setup
frontend/src/app/[locale]/setup/page.tsx - Diagnosis view
frontend/src/app/[locale]/diagnosis/page.tsx - Climate futures view
frontend/src/app/[locale]/climate/page.tsx - Pathways view
frontend/src/app/[locale]/pathways/page.tsx - Investment view
frontend/src/app/[locale]/investment/page.tsx - Community view
frontend/src/app/[locale]/community/page.tsx - Monitoring view
frontend/src/app/[locale]/monitoring/page.tsx
Application API
- FastAPI application
backend/app/main.py - Domain API routes
backend/app/routers - Agent API
backend/app/routers/agents.py - MCP REST façade
backend/app/routers/mcp_router.py
Landscape intelligence
- Diagnosis engines
backend/app/engines/indicator_engine.py - Syndrome classification
backend/app/engines/syndrome_classifier.py - Landscape health index
backend/app/engines/landscape_health_index.py - Climate futures agent
backend/app/agents/climate_futures_agent.py - Pathway generation
backend/app/engines/pathway_generator.py - Investment priority
backend/app/engines/priority_index.py - Adaptive monitoring
backend/app/agents/adaptive_monitoring_agent.py - Landscape evidence agent
backend/app/agents/landscape_evidence_agent.py
Data and knowledge
- Geospatial data adapters
backend/app/data_adapters/planetary_computer.py - CMIP6 adapter
backend/app/data_adapters/cmip6_adapter.py - CGIAR evidence adapter
backend/app/data_adapters/gardian_adapter.py - Evidence ingestion and retrieval
backend/app/rag/ingestion.py
Tooling and services
- Scientific MCP tools
backend/app/mcp/server.py - Narrative generation
backend/app/services/llm_service.py
Other components
- Landscape decision-maker
- Scientific data providers
Connections 33
- Landscape decision-maker → Decision pages: uses
- Decision pages → Project setup: starts project
- Project setup → FastAPI application: submits project
- Decision pages → Diagnosis view: reviews diagnosis
- Decision pages → Climate futures view: reviews climate
- Decision pages → Pathways view: reviews pathways
- Decision pages → Investment view: reviews investment
- Decision pages → Community view: reviews community
- Decision pages → Monitoring view: reviews monitoring
- FastAPI application → Domain API routes: mounts routes
backend/app/main.py - FastAPI application → Agent API: mounts routes
backend/app/main.py - FastAPI application → MCP REST façade: mounts routes
backend/app/main.py - Domain API routes → Diagnosis engines: runs diagnosis
- Domain API routes → Climate futures agent: requests climate assessment
- Domain API routes → Pathway generation: requests pathways
- Domain API routes → Investment priority: supports investment ranking
- Domain API routes → Adaptive monitoring: requests monitoring
- Domain API routes → Landscape evidence agent: requests evidence
- Diagnosis engines → Syndrome classification: classifies syndromes
- Diagnosis engines → Landscape health index: scores health
- Landscape evidence agent → Geospatial data adapters: orchestrates sources
- Scientific data providers → Geospatial data adapters: provides observations
- Scientific data providers → CMIP6 adapter: provides projections
- Scientific data providers → CGIAR evidence adapter: provides publications
- Domain API routes → Evidence ingestion and retrieval: serves knowledge search
backend/app/routers/rag.py - Domain API routes → CGIAR evidence adapter: harvests evidence
backend/app/routers/rag.py - MCP REST façade → Scientific MCP tools: dispatches tools
- Scientific MCP tools → Diagnosis engines: runs diagnostic tools
backend/app/mcp/server.py - Scientific MCP tools → CMIP6 adapter: fetches climate data
backend/app/mcp/server.py - Scientific MCP tools → CGIAR evidence adapter: searches evidence
backend/app/mcp/server.py - Scientific MCP tools → Evidence ingestion and retrieval: retrieves documents
backend/app/mcp/server.py - Scientific MCP tools → Pathway generation: generates packages
backend/app/mcp/server.py - Scientific MCP tools → Narrative generation: generates narratives
backend/app/mcp/server.py