ClinIQ is an innovative open-source health-tech platform that leverages AI to provide accurate symptom analysis and doctor discovery—all in one place. Our goal is to make healthcare more accessible and user-friendly for everyone.
Millions face delays and confusion when accessing healthcare. Getting a preliminary understanding of symptoms can be difficult, and finding the right specialist is often a challenge.
ClinIQ addresses these challenges by providing:
- 🧠 AI Symptom Checker: Get instant, personalized health insights.
- 👩⚕️ Doctor Directory: Find verified specialists by expertise.
- 💬 Chat Interface: An interactive way to get feedback on symptoms.
- 📱 Responsive UI: A modern and smooth user experience on any device.
- 📅 Appointment Booking: Book and manage appointments with ease.
- 🏥 Hospital Locator: Find nearby hospitals using your PIN code.
Follow these steps to get a local copy running:
- Node.js (v18 or higher)
- npm or yarn
-
Fork the repository
-
Clone the repository
git clone https://github.com/YOUR_USERNAME/ClinIQ.git
-
Navigate to the project directory
cd ClinIQ
-
Install dependencies
npm install # or yarn install
-
Set up environment variables
Copy.env.example
to.env
and fill in your keys.- Supabase: Sign up at https://supabase.com/ to get
VITE_SUPABASE_URL
andVITE_SUPABASE_ANON_KEY
. - Gemini API: Get your key from https://aistudio.google.com/api-keys.
- Supabase: Sign up at https://supabase.com/ to get
-
Run the development server
npm run dev # or yarn dev
Open http://localhost:5173 in your browser to view the app.
We welcome contributions from everyone, especially during Hacktoberfest! Your help is essential for making ClinIQ better.
Please read our CONTRIBUTING.md for detailed instructions.
- Create a new branch for each PR (do not commit directly to
main
).
Example:fix/sign-in-text
orfeature/new-component
- Reference the issue in your PR title or description.
Example:Fix: Sign-In Text Cut Off #2
- Include screenshots or GIFs for UI changes.
- PRs will be reviewed by maintainers. Be prepared to make requested changes before merge.
good first issue
: Ideal for newcomers.hacktoberfest
: Issues for Hacktoberfest contributors.bug
: Something isn’t working as expected.UI/UX
: Involves improving interface or user experience.
Layer | Technologies |
---|---|
Frontend | React.js, TypeScript, Tailwind CSS, Framer Motion |
Backend | Supabase |
Database | Supabase (PostgreSQL) |
AI API | Gemini API |
- 📊 Advanced Dashboards: For patients, doctors, and admins with actionable insights.
- 🔐 Enhanced Security: End-to-end encryption and role-based access controls.
- 🔔 Real-time Notifications: Appointment alerts and health reminders.
This project is licensed under the MIT License. See the LICENSE file for details.
If you find ClinIQ helpful, please give it a ⭐ star on GitHub!
For questions or feedback, reach out to akshay.allen26200@gmail.com