How hunainasif/openclinic works
Open Clinic AI is a healthcare voice receptionist with an admin dashboard. The primary workflow is a browser voice turn through transcription, guarded multi-agent routing, clinic-document retrieval or appointment actions, then spoken response; emergencies trigger notification. The dashboard separately manages appointments, doctors and schedules, knowledge documents, call history, and analytics. The graph preserves these documented capabilities, but many voice, agent, dashboard-service, and analytics implementations were not sampled, so those links are documented or marked unverified rather than inferred from module names.
Main entry points: prisma.ts PostgreSQL · appointment.node.ts Booking specialist · supervisor.node.ts Turn supervisor · knowledgeBase.controller.ts Knowledge API
Components 34
Voice and agents
- Voice session
apps/api/src/sockets/handlers/voice-turn.ts - Speech recognition
apps/api/src/libs/deepgram.ts - Agent graph
apps/api/src/agents/graph.ts - Input guardrail
apps/api/src/agents/guardrail.node.ts - Turn supervisor
apps/api/src/agents/supervisor.node.ts - FAQ specialist
apps/api/src/agents/faq.node.ts - Booking specialist
apps/api/src/agents/appointment.node.ts - Emergency specialist
apps/api/src/agents/emergency.node.ts - Speech synthesis
apps/api/src/libs/elevenlabs.ts - Clinic email
apps/api/src/libs/mailer.ts
Clinic knowledge
- Uploaded documents
apps/api/src/controllers/knowledgeBase.controller.ts - Text extraction
apps/api/src/helpers/textExtraction.ts - Document ingestion
apps/api/src/helpers/knowledgeBase.ts - Vector retrieval
apps/api/src/libs/vectorStore.ts - Pinecone
apps/api/src/libs/pinecone.ts
API and persistence
- Appointment API
apps/api/src/controllers/appointments.controller.ts - Appointment data access
apps/api/src/data/appointments.data.ts - Doctor API
apps/api/src/controllers/doctors.controller.ts - Schedule API
apps/api/src/controllers/schedules.controller.ts - Schedule exceptions
apps/api/src/controllers/exceptions.controller.ts - Knowledge API
apps/api/src/controllers/knowledgeBase.controller.ts - Call records API
apps/api/src/controllers/call.controller.ts - Analytics API
apps/api/src/controllers/analytics.controller.ts - PostgreSQL
apps/api/src/libs/prisma.ts
Web experience
- Voice interface
apps/web/src/components/call/call-overlay.tsx - Admin dashboard
apps/web/src/app/(app)/dashboard/page.tsx - Appointment management
apps/web/src/app/(app)/appointments/page.tsx - Doctor management
apps/web/src/app/(app)/doctors/page.tsx - Knowledge management
apps/web/src/app/(app)/knowledge-base/page.tsx - Call history
apps/web/src/app/(app)/calls/page.tsx - Analytics
apps/web/src/app/(app)/analytics/page.tsx
Other components
- Caller
- Clinic administrator
- Deepgram
Connections 42
- Caller → Voice interface: starts call
README.md - Voice interface → Voice session: streams turns
README.md - Voice session → Speech recognition: transcribes audio
README.md - Speech recognition → Agent graph: passes transcript
README.md - Agent graph → Input guardrail: starts turn
README.md - Input guardrail → Turn supervisor: allows input
README.md - Turn supervisor → FAQ specialist: routes turn
README.md - Turn supervisor → Booking specialist: routes turn
README.md - Turn supervisor → Emergency specialist: routes turn
README.md - FAQ specialist → Vector retrieval: retrieves context
README.md - FAQ specialist → Speech synthesis: returns answer
README.md - Booking specialist → Appointment API: books appointment
- Booking specialist → Doctor API: looks up doctors
- Booking specialist → Schedule API: checks schedules
- Booking specialist → Clinic email: emails confirmation
README.md - Emergency specialist → Clinic email: sends alert
README.md - Speech synthesis → Voice session: streams speech
README.md - Voice session → Voice interface: returns audio
README.md - Clinic administrator → Admin dashboard: manages clinic
README.md - Clinic administrator → Appointment management: manages bookings
README.md - Clinic administrator → Doctor management: manages doctors
README.md - Clinic administrator → Knowledge management: manages documents
README.md - Clinic administrator → Call history: reviews calls
README.md - Clinic administrator → Analytics: reviews analytics
README.md - Appointment management → Appointment API: uses API
- Doctor management → Doctor API: uses API
- Knowledge management → Knowledge API: uses API
- Call history → Call records API: uses API
- Analytics → Analytics API: uses API
- Appointment API → Appointment data access: reads and writes
apps/api/src/controllers/appointments.controller.ts - Appointment data access → PostgreSQL: queries database
apps/api/src/data/appointments.data.ts - Knowledge API → Text extraction: extracts text
apps/api/src/controllers/knowledgeBase.controller.ts - Knowledge API → Document ingestion: ingests document
apps/api/src/controllers/knowledgeBase.controller.ts - Knowledge API → Uploaded documents: stores document record
apps/api/src/controllers/knowledgeBase.controller.ts - Document ingestion → Pinecone: indexes vectors
apps/api/src/helpers/knowledgeBase.ts - Vector retrieval → Pinecone: searches vectors
- Uploaded documents → PostgreSQL: persists metadata
- Doctor API → PostgreSQL: persists doctors
- Schedule API → PostgreSQL: persists schedules
- Schedule exceptions → PostgreSQL: persists exceptions
- Call records API → PostgreSQL: persists call history
- Analytics API → PostgreSQL: reads metrics