An AI-powered healthcare assistant that provides medical information, symptom analysis, and health recommendations using Google's Gemini AI. Supporting multiple languages for global accessibility! 🌍
Your Hacktoberfest contribution will be marked INVALID if you don't star the repository!
👆 Click above to star the repo - It takes 2 seconds!
We're excited to participate in Hacktoberfest 2025! This is the perfect opportunity for open source developers to contribute to a meaningful healthcare project. Whether you're fixing bugs, adding features, improving documentation, or enhancing the UI, your contributions are welcome!
- ⭐ STAR THE REPOSITORY - This is MANDATORY for valid contributions
- 📖 Read our CONTRIBUTING.md thoroughly
- 🔍 Find an issue or create a new one
- ⏳ Wait for maintainer assignment before starting work
- 🎯 Submit focused, quality PRs
We accept meaningful contributions:
- 💻 Code Contributions: Bug fixes, new features, refactoring
- 🎨 UI/UX Redesigns: Design improvements, responsive fixes, accessibility enhancements
- 📚 Documentation: README updates, code comments, guides, tutorials
- 🧪 Testing: Writing tests, improving test coverage
- 🐛 Bug Reports: Finding and reporting issues with detailed information
- 💡 Feature Proposals: Well-thought-out feature requests with mockups/diagrams
- 🌍 Translations: Adding language support
- ♿ Accessibility: Making the app more accessible
We Do NOT Accept:
- ❌ PRs without starring the repo first
- ❌ Working without issue assignment
- ❌ Spammy PRs: Minor changes just to get a PR count (e.g., adding spaces, removing empty lines)
- ❌ Low-Effort Contributions: Changes that add no real value
- ❌ Copy-Paste Code: Directly copying code from other projects without understanding
- ❌ Massive Unfocused PRs: Trying to add 5+ features in one PR
- ❌ Incomplete Work: PRs that are half-done or don't work properly
- ❌ README Only Changes: Just adding your name without meaningful contribution
- Well-documented: Clear description of what and why
- Tested: You've tested your changes locally
- Focused: Addresses one specific issue or feature
- Quality code: Follows project conventions and best practices
- Meaningful: Adds real value to the project and its users
- ⭐ Star the repo - Click here (MANDATORY!)
- Find an issue - Check our Good First Issues or Hacktoberfest labeled issues
- Comment on the issue - Express your interest: "I'd like to work on this"
- Wait for assignment - Maintainers will assign the issue to you
- Fork the repo - Click the 'Fork' button at the top right
- Create your branch - Use descriptive names:
git checkout -b feature/your-feature-name - Make your changes - Follow our contribution guidelines
- Add yourself to CONTRIBUTORS.md - Celebrate your contribution!
- Submit a PR - Create a pull request and our maintainers will review it
- 🌐 Multilingual Support: Get healthcare assistance in multiple languages
- 🔍 Symptom Analysis: AI-powered analysis with severity assessment and recommendations
- 💊 Drug Interaction Checker: Check potential interactions between medications
- 📚 Medical Term Explainer: Understand complex medical terminology in simple language
- 📄 Medical Report Assistant: Upload and get AI-powered summaries and Q&A for medical reports
- 💬 Healthcare Chat: Interactive chat with AI for health-related queries
- 🚨 Emergency Contacts: Quick access to important emergency numbers
- 🇬🇧 English
- 🇮🇳 Hindi
- 🇪🇸 Spanish
- 🇫🇷 French
- 🇩🇪 German
- 🇨🇳 Chinese
- 🇯🇵 Japanese
- 🇰🇷 Korean
- 🇸🇦 Arabic
- And more...
- ⚛️ React.js - UI framework
- ⚡ Vite - Build tool
- 🤖 Gemini AI API - AI-powered responses
- 🎨 Tailwind CSS - Styling
- 📘 TypeScript - Type safety
Visit the live application: HealthAI Assistant
- Getting Started
- Development Setup
- Contributing
- Project Structure
- Available Scripts
- Feature Roadmap
- Usage Guide
- Code of Conduct
- Contributors
- License
- Node.js (version 16 or higher)
- npm or yarn
- Gemini AI API key
- Clone the repository:
git clone https://github.com/NikhilRaikwar/HealthAI-Assistant.git
cd HealthAI-Assistant- Install dependencies:
npm install- Set up environment variables:
- Create a
.envfile in the root directory - Add your Gemini AI API key:
- Create a
VITE_GEMINI_API_KEY=your_gemini_api_key_here- Start the development server:
npm run devThe application will be available at http://localhost:5173
-
Set up your development environment:
- Make sure you have Node.js installed (v16+ recommended)
- Use a code editor like VS Code with these recommended extensions:
- ES7+ React/Redux/React-Native snippets
- Prettier - Code formatter
- ESLint
- Tailwind CSS IntelliSense
-
Understand the project structure: See Project Structure section below
-
Follow our coding standards:
- Use functional components with hooks
- Follow the existing code style and formatting
- Write meaningful commit messages
- Add comments for complex logic
We welcome all types of contributions! Here are some ways you can help:
- Fix typos in documentation
- Resolve UI/UX issues
- Solve functional bugs
- Fix responsive design issues
- Redesign existing components
- Improve responsive design
- Add animations and micro-interactions
- Enhance accessibility (WCAG compliance)
- Improve dark/light mode consistency
- Add new language support
- Implement new healthcare features
- Create new utility components
- Voice input for symptom analysis
- Session history tracking
- Export/download functionality
- Improve README documentation
- Add code comments and JSDoc
- Create contribution guides
- Write tutorials and how-to guides
- Add API documentation
- Performance optimizations
- Code refactoring
- Add unit tests
- Implement TypeScript
- Improve error handling
Before contributing, please read our detailed CONTRIBUTING.md file!
- ⭐ Star the repository (MANDATORY!)
- 🔍 Find an issue or create a new one if you have an idea
- 💬 Comment on the issue expressing interest
- ⏳ Wait for assignment from a maintainer
- 🍴 Fork the repository and create your feature branch
- 💻 Make your changes following our code standards
- 🧪 Test your changes thoroughly
- 📝 Add yourself to CONTRIBUTORS.md
- 🚀 Submit a pull request with a clear description
- ✅ Provide a clear title and description
- ✅ Reference any related issues (e.g., "Closes #123")
- ✅ Include screenshots for UI changes
- ✅ Ensure all tests pass
- ✅ Follow the PR template
- ✅ Keep PRs focused (one feature/fix per PR)
HealthAI-Assistant/
├── README.md
├── components.json
├── CONTRIBUTING.md
├── CONTRIBUTORS.md
├── eslint.config.js
├── index.html
├── LICENSE
├── package.json
├── postcss.config.js
├── tailwind.config.js
├── tsconfig.app.json
├── tsconfig.json
├── tsconfig.node.json
├── vite.config.ts
├── .hintrc
├── public/ # Static files
│ ├── robots.txt
│ ├── site.webmanifest
│ └── sitemap.xml
├── src/
│ ├── App.tsx # Main application component
│ ├── index.css # Global styles
│ ├── main.tsx # Application entry point
│ ├── vite-env.d.ts # Vite environment types
│ ├── components/ # React components
│ │ ├── About.tsx
│ │ ├── AppContent.tsx
│ │ ├── DrugInteraction.tsx
│ │ ├── Emergency.tsx
│ │ ├── HealthcareChat.tsx
│ │ ├── HealthcareLogo.tsx
│ │ ├── Homepage.tsx
│ │ ├── MedicalTermExplainer.tsx
│ │ ├── PolicyQueryAssistant.tsx
│ │ ├── ReportSummarizer.tsx
│ │ ├── SymptomAnalyzer.tsx
│ │ ├── navigation/ # Navigation components
│ │ │ ├── MobileMenu.tsx
│ │ │ ├── Navbar.tsx
│ │ │ ├── NavItem.tsx
│ │ │ ├── NavLogo.tsx
│ │ │ └── ThemeToggle.tsx
│ │ └── ui/ # Reusable UI components
│ │ ├── bento-grid.tsx
│ │ ├── button.tsx
│ │ ├── ChatInput.tsx
│ │ ├── MessageList.tsx
│ │ ├── navigation-menu.tsx
│ │ └── PageContainer.tsx
│ ├── config/ # Configuration files
│ │ └── navigation.ts
│ ├── context/ # React context providers
│ │ ├── NavigationContext.tsx
│ │ └── ThemeContext.tsx
│ ├── lib/ # External library configurations
│ │ ├── gemini.ts # Gemini AI integration
│ │ └── utils.ts # Utility helper functions
│ ├── types/ # TypeScript type definitions
│ │ └── index.ts
│ └── utils/ # Utility functions
│ └── pdfUtils.ts # PDF processing utilities
└── .github/ # GitHub configuration
├── PULL_REQUEST_TEMPLATE.md
└── ISSUE_TEMPLATE/
├── bug_report.md
├── feature_request.md
└── ui_redesign.md
# Start development server
npm run dev
# Build for production
npm run build
# Preview production build
npm run preview
# Run linter
npm run lint
# Format code
npm run format- 🧪 Add comprehensive unit testing
- 📱 Enhance mobile responsiveness
- ✅ Add medical report validation
- ♿ Improve accessibility (WCAG 2.1 AA compliance)
- 📊 PWA capabilities for offline support
- 🎙️ Voice input support for symptom analysis
- 💊 Medication reminder system
- 📈 Health tracking dashboard
- 🔌 Integration with health APIs
- 📥 Export health reports (PDF/JSON)
- 👥 Multi-user support with profiles
- 🔔 Real-time notifications
- 📍 Location-based emergency services
- Navigate to the Symptom Analysis section
- Enter your symptoms in natural language
- Get AI-powered analysis with potential causes
- Receive personalized recommendations
- Access the Drug Interaction Checker
- Input multiple medications
- Check for potential interactions
- View safety recommendations
- Use the Medical Term Explainer
- Look up complex medical terms
- Get clear, simple explanations
- Understand your medical reports better
- Upload medical reports (PDF format)
- Ask questions about your report in natural language
- Get AI-powered answers and explanations
- Understand test results and diagnoses clearly
- Start a conversation with the AI assistant
- Ask health-related questions
- Get instant, informative responses
- Continue conversation with context
Maintainer: Nikhil Raikwar
GitHub: @NikhilRaikwar
Project Link: https://github.com/NikhilRaikwar/HealthAI-Assistant
- Google for providing the Gemini AI API
- The open source community for invaluable tools and libraries
- All our amazing contributors who help make this project better
We're thrilled to be part of Hacktoberfest 2025! Here's what makes our project great for contributors:
- 💙 Real Impact: Your code helps people access healthcare information
- 🌱 Beginner Friendly: Well-documented codebase with good first issues
- 🚀 Modern Stack: Work with React, Vite, and modern web technologies
- 🤝 Supportive Community: Friendly maintainers and contributors
- 📚 Learning Opportunity: Gain experience with AI integration and healthcare tech
- ✅ Get your Hacktoberfest PRs merged
- 🎖️ Receive contributor shoutouts
- 💼 Build your open source portfolio
- 📚 Learn from code reviews
- 🤝 Join a growing community
- 🌟 Get featured in our contributors section
🌱 For Beginners:
- 📝 Fix typos in documentation
- 🎨 Improve UI styling and colors
- ⏳ Add loading states to components
- 💬 Create better error messages
- 📖 Add helpful code comments
- 🔧 Fix mobile responsive issues
🚀 For Intermediate:
- 🆕 Add new UI components
- 🎙️ Implement voice input feature
- 📊 Create data visualization components
- 🧪 Write unit tests for existing features
- ⚡ Optimize component performance
- ♿ Add accessibility features (ARIA labels, keyboard navigation)
🔥 For Advanced:
- 📘 Add TypeScript type definitions
- 🏗️ Implement advanced features (session history, export data)
- 🔄 Set up CI/CD pipeline
- 🧪 Add integration tests
- ♻️ Refactor complex logic for better maintainability
- 📱 Create Progressive Web App (PWA) support
We love our contributors! All contributors are shown below with their GitHub profile images. Your face could be here too—just contribute! 😄
Want to see your face here? Start contributing now! 🚀
Please be respectful and considerate in all interactions. We are committed to providing a welcoming and inclusive experience for everyone. See our Code of Conduct for details.
This project is licensed under the MIT License - see the LICENSE file for details.
⭐ If you like this project, please star the repo! ⭐
Let's build something amazing together! 🚀
Quality contributions are always welcome!
Remember: This application provides AI-powered health information and should not replace professional medical advice. Always consult healthcare professionals for medical concerns.
Made with ❤️ by the HealthAI Assistant Community