How rohanthomas1202/agentforge-healthcare works
AgentForge Healthcare is a healthcare assistant: a user submits a clinical query through the web UI, the API invokes a LangGraph agent, and the agent selects tools to retrieve or analyze EHR and domain data. The response then passes a six-check verification pipeline before returning with metadata. The graph also preserves conversation history, observability, and the documented clinical-tool branches. Some tool implementations were not sampled; those capabilities and their relationships are shown only where documented in the README or SOURCE INDEX.
Main entry points: registry.py Tool registry · graph.py LangGraph agent · fhir_client.py FHIR client · routes.py API routes
Components 29
User experience
- Web UI
frontend-v2/js/app.js - Browser API client
frontend-v2/js/api.js
Agent orchestration
- API routes
app/api/routes.py - LangGraph agent
app/agent/graph.py - Input sanitization
app/agent/input_sanitizer.py
Clinical capabilities
- Tool registry
app/tools/registry.py - Patient summary
app/tools/patient_summary.py - Symptom lookup
app/tools/symptom_lookup.py - Provider search
app/tools/provider_search.py - Appointment availability
app/tools/appointment_availability.py - Clinical trials
app/tools/clinical_trials.py - Drug interactions
app/tools/drug_interaction.py - Allergy checks
app/tools/allergy_checker.py - FDA drug safety
app/tools/fda_drug_safety.py - Drug recalls
app/tools/drug_recall.py - Care gaps
app/tools/care_gap_analysis.py - Insurance coverage
app/tools/insurance_coverage.py - Lab results
app/tools/lab_results.py - Record vitals
app/tools/record_vitals.py
EHR and persistence
- EHR abstraction
app/ehr_provider.py - FHIR client
app/fhir_client.py - Mock FHIR client
app/mock_fhir_client.py - OpenEMR FHIR
- OpenEMR MariaDB
- Conversation store
app/database.py
Safety and operations
- Verification pipeline
app/verification/pipeline.py - Six verifiers
app/verification - Observability
app/observability.py
Other components
- User
Connections 30
- User → Web UI: submits query
- Web UI → Browser API client: uses
frontend-v2/js/app.js - Browser API client → API routes: calls API
frontend-v2/js/api.js - API routes → LangGraph agent: invokes
app/api/routes.py - LangGraph agent → Tool registry: dispatches tools
app/agent/graph.py - Tool registry → Patient summary: registers
app/tools/registry.py - Tool registry → Symptom lookup: registers
app/tools/registry.py - Tool registry → Provider search: registers
app/tools/registry.py - Tool registry → Appointment availability: registers
app/tools/registry.py - Tool registry → Clinical trials: registers
app/tools/registry.py - Tool registry → Drug interactions: registers
app/tools/registry.py - Tool registry → Allergy checks: registers
app/tools/registry.py - Tool registry → FDA drug safety: registers
app/tools/registry.py - Tool registry → Drug recalls: registers
app/tools/registry.py - Tool registry → Care gaps: registers
app/tools/registry.py - Tool registry → Insurance coverage: registers
app/tools/registry.py - Tool registry → Lab results: registers
app/tools/registry.py - Tool registry → Record vitals: registers
app/tools/registry.py - LangGraph agent → Verification pipeline: verifies response
app/agent/graph.py - Verification pipeline → Six verifiers: runs checks
app/verification/pipeline.py - LangGraph agent → Observability: records metrics
app/agent/graph.py - API routes → Conversation store: reads and writes
app/api/routes.py - Provider search → FHIR client: searches FHIR
app/tools/provider_search.py - Insurance coverage → OpenEMR MariaDB: queries coverage
app/tools/insurance_coverage.py - Insurance coverage → FHIR client: looks up patient
app/tools/insurance_coverage.py - FHIR client → EHR abstraction: implements
app/fhir_client.py - Mock FHIR client → EHR abstraction: implements
app/mock_fhir_client.py - FHIR client → OpenEMR FHIR: requests FHIR data
- LangGraph agent → Input sanitization: sanitizes inputs
- LangGraph agent → User: returns verified response