How yuraj023/biodiversity_chatbot works
Biodiversity Intelligence Chatbot is an environmental decision-support application. Users provide conditions through chat, structured fields, or JSON; the backend accumulates chat state, requests clarification when inputs are sparse, analyzes ecological risks and relationships, retrieves scientific evidence, and returns recommendations for the dashboard to display. The graph preserves the documented ingestion/index and synthesis capabilities. Some backend implementation is only partially excerpted, so unverified internal links are omitted; README-documented relationships are cited to the README.
Main entry points: main.py FastAPI Endpoints · Dashboard.jsx Dashboard Inputs · reasoning.py Risk And Recommendation Engine · rag.py Semantic Retrieval
Components 18
User Interface
- App State And API
frontend/src/App.jsx - Dashboard Inputs
frontend/src/Dashboard.jsx - Chat Input
frontend/src/components/Chat.jsx
API And State
- FastAPI Endpoints
backend/main.py - Environmental Schemas
backend/models.py - Conversation Memory
backend/memory.py - Clarification Builder
backend/clarifier.py
Environmental Analysis
- Risk And Recommendation Engine
backend/reasoning.py - Synthesis Prompts
backend/prompt
Scientific Knowledge
- Semantic Retrieval
backend/rag.py - Scientific Documents
data/documents - FAISS Index And Metadata
vectorstore/faiss_index
Results Presentation
- Metrics View
frontend/src/components/Metrics.jsx - Reasoning View
frontend/src/components/Reasoning.jsx - Recommendations View
frontend/src/components/Recommendations.jsx - Evidence View
frontend/src/components/Evidence.jsx
Other components
- User
- Google Gemini
Connections 22
- User → Dashboard Inputs: provides conditions
README.md - Dashboard Inputs → Chat Input: renders chat
frontend/src/Dashboard.jsx - Dashboard Inputs → App State And API: invokes callbacks
frontend/src/Dashboard.jsx - App State And API → FastAPI Endpoints: posts chat or analysis
frontend/src/App.jsx - FastAPI Endpoints → Environmental Schemas: validates requests
backend/main.py - FastAPI Endpoints → Conversation Memory: stores conversation
backend/main.py - FastAPI Endpoints → Clarification Builder: requests clarification
backend/main.py - FastAPI Endpoints → Risk And Recommendation Engine: runs analysis
backend/main.py - Conversation Memory → Environmental Schemas: extracts state
backend/memory.py - Risk And Recommendation Engine → Semantic Retrieval: retrieves evidence
backend/reasoning.py - Semantic Retrieval → Scientific Documents: indexes and searches
backend/rag.py - Semantic Retrieval → FAISS Index And Metadata: loads and writes
backend/rag.py - Risk And Recommendation Engine → Synthesis Prompts: loads synthesis prompt
- Risk And Recommendation Engine → Google Gemini: synthesizes recommendations
README.md - FastAPI Endpoints → Metrics View: returns environmental state
- FastAPI Endpoints → Reasoning View: returns risks and relationships
- FastAPI Endpoints → Recommendations View: returns interventions
- FastAPI Endpoints → Evidence View: returns citations
- Dashboard Inputs → Metrics View: renders metrics
frontend/src/Dashboard.jsx - Dashboard Inputs → Reasoning View: renders reasoning
frontend/src/Dashboard.jsx - Dashboard Inputs → Recommendations View: renders recommendations
frontend/src/Dashboard.jsx - Dashboard Inputs → Evidence View: renders evidence
frontend/src/Dashboard.jsx