MedScribe is a powerful healthcare AI-Agent platform that helps medical professionals streamline their workflow, reduce administrative burden, and focus more on patient care. The application leverages AI to manage transcriptions, automate documentation, and optimize scheduling.

• AI-Powered Transcription: Automatically transcribe patient conversations and medical notes
• Smart Documentation: Generate and organize medical documentation with AI assistance
• Dashboard Analytics: Track metrics and visualize workflow efficiency
• Patient Management: Maintain comprehensive patient records
• Calendar Integration: Manage appointments and schedules efficiently
• Workflow Automation: Streamline repetitive tasks and administrative processes

• Frontend: Next.js 15, Tailwind CSS, ShadCN, Framer Motion
• Backend: ElevenLabs, Google Gemini, Twilio, Node.js, MongoDB Atlas, Fastify, ngrok
• Hardware: Meta Ray-Ban Glasses
• AI Integration: Google Generative AI

• WCAG Compliant Colors: High-contrast color scheme with explicitly AA-compliant combinations for essential UI elements and text
• Keyboard Navigation: Comprehensive focus management with visible indicators for all interactive elements
• Low Performance Mode: Automatic detection of connection speed with simplified UI options for bandwidth-sensitive users
• Screen Reader Compatibility: Semantic HTML with proper ARIA roles and hidden descriptive text for non-visual users
• Responsive Design: Adaptable layouts that function well across all device sizes with mobile-specific optimizations

• Node.js 18+
• npm or pnpm

1. Clone the repository

   git clone <repository-url>
   cd medscribe
   

2. Install dependencies

   npm install
   # or
   pnpm install
   

3. Create a .env file in the root directory with required environment variables:

   # Example .env file
   NEXT_PUBLIC_API_URL=http://localhost:3000/api
   GOOGLE_AI_API_KEY=your_api_key_here
   

4. Start the development server

   npm run dev
   # or
   pnpm dev
   

5. Open http://localhost:3000 in your browser to see the application

• /app: Main application routes and pages

  • /api: API routes for backend functionality
  • /dashboard: Dashboard views and components
  • /patients: Patient management interface
  • /calendar: Calendar and scheduling tools

• /components: Reusable React components

• /lib: Utility functions and shared code

• /public: Static assets

• /styles: Global CSS and styling configurations

• /data: Local data storage (for development)

• GET /api/transcriptions: Retrieve all transcriptions
• POST /api/transcriptions: Create a new transcription
• GET /api/transcriptions/[id]: Get a specific transcription by ID

• GET /api/patients: Retrieve all patients
• POST /api/patients: Create a new patient record

• GET /api/appointments: Retrieve all appointments
• POST /api/appointments: Create a new appointment