How sanjaykumar3110/mediscan works
MediScan is a Streamlit medical assistant whose main workflow turns an uploaded prescription into extracted text, then routes follow-up questions to medical chat or nearby-care search. The graph includes the documented safety and knowledge-base capabilities; the knowledge-base builder is present, but no runtime caller is shown. Edges follow excerpts or README workflow statements; unsampled implementation details are not inferred.
Main entry points: orchestrate.py Orchestrator · medic_agent.py Medical agent · chat_llm.py Medical chat · app.py Streamlit interface
Components 13
User interface
- Streamlit interface
app.py
Request routing
- Orchestrator
src/orchestrate.py
Prescription assistance
- Medical agent
src/agents/medic_agent.py - Prescription OCR
src/helpers/ocr_model.py - Medical chat
src/helpers/chat_llm.py
Care discovery
- Location agent
src/agents/locate_agent.py - Facility search
src/helpers/doc_locate.py
Safety and knowledge
- Local LLM loader
src/helpers/validate.py - Safety validation
src/helpers/validate.py - Knowledge-base builder
src/helpers/build_kb.py
Other components
- User
- OpenStreetMap Nominatim
- Persistent vector store
Connections 13
- User → Streamlit interface: uploads and asks
README.md - Streamlit interface → Orchestrator: routes requests
app.py - Orchestrator → Medical agent: dispatches image or chat
src/orchestrate.py - Orchestrator → Location agent: dispatches location
src/orchestrate.py - Medical agent → Prescription OCR: extracts prescription
src/agents/medic_agent.py - Medical agent → Medical chat: delegates chat
src/agents/medic_agent.py - Medical chat → Local LLM loader: loads model
src/helpers/chat_llm.py - Medical chat → Safety validation: validates response
src/helpers/chat_llm.py - Location agent → Facility search: searches facilities
src/agents/locate_agent.py - Facility search → OpenStreetMap Nominatim: queries places
src/helpers/doc_locate.py - Knowledge-base builder → Persistent vector store: writes collections
src/helpers/build_kb.py - Orchestrator → Safety validation: validates responses
README.md - Orchestrator → Streamlit interface: returns answer
README.md