Documentation
AI-Powered Homeopathy Web Application
Advanced AI-powered homeopathy software for intelligent remedy suggestion and patient consultation
About This Application
HomeOSense is a cutting-edge AI-powered homeopathy web application designed to revolutionize the way homeopathic practitioners deliver patient care and remedy recommendations.
Intelligent Analysis
Our AI system analyzes symptoms through the Kent Repertory method to provide the most accurate remedy recommendations based on comprehensive case-taking.
Professional Grade
Built for homeopathic professionals, featuring dual-provider validation, comprehensive patient history tracking, and evidence-based recommendations.
Live AI Physician Chat
Interactive case-taking with AI through Kent questionnaire and conversational interface for natural, patient-friendly consultation experience.
Voice-Enabled Input
Integrated voice input functionality allowing patients and practitioners to describe symptoms naturally using microphone input with automatic transcription.
Key Features
Advanced AI Suggestions with Live Chat
Interactive Kent questionnaire with 20 targeted questions. AI asks questions progressively to gather comprehensive patient information for accurate remedy selection.
Dual-Provider System with Auto-Fallback
Utilizes Google Gemini and Groq AI providers with automatic fallback mechanism. If primary provider fails, system seamlessly switches to backup provider.
Voice Input & Transcription
Click microphone button to record symptoms and answers. Browser-based speech recognition automatically transcribes voice input to text in real-time.
Comprehensive Remedy Analysis
AI analyzes case details and provides multiple remedy recommendations with potency, dosage, rationale, lifestyle modifications, and cautions.
PDF Export & Sharing
Export remedy recommendations as professional PDF with clinic header, or share directly via WhatsApp with patients.
Secure Data Management
API keys encrypted with AES-256-GCM and stored securely in database. Patient information protected with enterprise-grade security.
How to Use This Application
1Initial Setup
- Sign Up:Create account with your email and clinic details
- Configure API Keys:Go to Settings → Add Google Gemini or Groq API keys (at least one required)
- Clinic Details:Fill in clinic name, address, and doctor details for professional output
2Standard Consult (Basic AI)
- Navigate:Go to Consult → Enter patient name and chief complaint
- Submit:Click "Submit" to get AI analysis and remedy suggestions
- Export:Export as PDF or share via WhatsApp with patient
3Advanced AI Suggestions (Live Chat with AI Physician)
- Navigate:Go to Advanced AI Suggestions in sidebar
- Enter Details:Fill patient name, age, gender, and chief complaint
- Select Provider:Choose between Gemini or Groq (both available, auto-fallback if needed)
4Using Voice Input
- Click Mic:Click microphone (🎤) button next to text input
- Speak:Speak clearly into your microphone (allow browser access when prompted)
- Transcribe:Text appears automatically; click Stop or continue speaking
- Submit:Review transcribed text and click "Submit Answer"
5Interview Flow (20-Question Kent Questionnaire)
- Questions 1-5:AI asks about symptom characteristics, timing, and modalities
- Questions 6-12:Mental state, sleep patterns, cravings, and constitutional factors
- Question 15:System asks: continue 5 more questions or analyze now?
- Questions 16-20:Refine understanding of peculiar symptoms (if chosen)
- Analysis:AI provides comprehensive remedy recommendations with rationale
6Viewing & Exporting Remedy Recommendations
- Remedy Details:View potency, dosage, schedule, rationale, and lifestyle modifications
- Alternatives:See why other remedies weren't selected with detailed explanations
- Export PDF:Click "Save / Print as PDF" for professional document with clinic header
- WhatsApp Share:Click "Send via WhatsApp" to share with patient directly
Technology Stack
Frontend
- • Next.js 16.0.7 with React 18
- • TypeScript for type safety
- • Tailwind CSS + shadcn/ui
- • Framer Motion for animations
Backend & Services
- • Next.js API Routes
- • Supabase (Auth + Database)
- • Node.js runtime
- • RESTful API architecture
AI Providers
- • Google Gemini (Primary)
- • Groq Llama (Fallback)
- • Web Speech API (Voice)
- • Auto-fallback mechanism
Security
- • AES-256-GCM encryption
- • JWT authentication
- • Secure database storage
- • HTTPS communication
Frequently Asked Questions
Do I need API keys to use this app?
Yes, at least one API key is required (Google Gemini or Groq). You can get them for free: Google Gemini from aistudio.google.com and Groq from console.groq.com
What browsers support voice input?
Voice input works on Chrome, Edge, and Firefox. For best results, use the latest version of your browser and ensure microphone permissions are granted.
How long does the interview take?
A typical 20-question interview takes 10-15 minutes depending on answer length. You can choose to stop after 15 questions if sufficient information is gathered.
Is my patient data secure?
Yes, all data is encrypted with AES-256-GCM and stored securely in Supabase. API keys are encrypted per-user and never stored in plain text.
Can I export recommendations as PDF?
Yes, every remedy recommendation can be exported as a professional PDF with your clinic header, doctor name, address, and detailed remedy information.
What if the AI fails to generate a response?
The system automatically falls back from Gemini to Groq if either provider fails. You can also manually switch providers using the buttons in the interface.
How many questions are in the Kent interview?
The interview includes 20 targeted questions based on the Kent Repertory method. At question 15, you can choose to continue or analyze immediately.
Can multiple doctors use the same clinic account?
Each doctor should create their own account with their name. All accounts in a clinic can have the same clinic details configured in Settings.
Ready to Get Started?
Start using HomeOSense AI-powered homeopathy software to deliver better patient care with intelligent remedy suggestions and interactive case-taking.