Content
# 🏥 AI Hospital Management Platform
An AI-powered Hospital Management Platform built using **Next.js**, **FastAPI**, **Python**, and **Groq LLM**. This project was built to explore how AI can be integrated into real-world healthcare workflows using a modular architecture.
---
## 📌 About the Project
I built this project to learn how modern AI systems can be combined with a full-stack web application. Instead of creating a traditional CRUD application, I wanted to design a platform where users can interact with the system using natural language.
The application includes patient management, appointment scheduling, billing, reports, and an AI assistant. The backend is designed using a modular architecture so new hospital modules can be added easily in the future.
---
## ✨ Features
- 🤖 AI Assistant powered by Groq
- 👨⚕️ Patient Management
- 📅 Appointment Scheduling
- 💳 Billing Management
- 📊 Reports Dashboard
- ⚙️ Settings Module
- 🎨 Modern Medical-Themed UI
- 🌐 Next.js Frontend
- ⚡ FastAPI Backend
- 🗄️ SQLite Database
- 🧩 Modular Runtime & Skills Architecture
---
## 🏗️ Architecture
```
Next.js Frontend
│
▼
FastAPI Backend
│
▼
AI Runtime Engine
│
┌───────────────┼───────────────┐
▼ ▼ ▼
Skills MCP Servers Services
│
▼
Repository Layer
│
▼
SQLite Database
│
▼
Groq LLM
```
---
## 🛠️ Tech Stack
### Frontend
- Next.js
- React
- TypeScript
- Tailwind CSS
- GSAP
- Three.js
### Backend
- FastAPI
- Python
- SQLite
### AI
- Groq LLM
- MCP-inspired Architecture
---
## 📁 Project Structure
```
AI-Hospital-Platform/
├── api/
├── landing-page/
├── runtime/
├── skills/
├── services/
├── repositories/
├── database/
├── models/
├── mcp_servers/
└── README.md
```
---
## 🚀 Getting Started
### Clone Repository
```bash
git clone https://github.com/harshit2005-rgb/ai-hospital-management-platform.git
cd ai-hospital-management-platform
```
### Backend
```bash
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn api.main:app --reload
```
Backend will run on:
```
http://127.0.0.1:8000
```
### Frontend
```bash
cd landing-page
npm install
npm run dev
```
Frontend will run on:
```
http://localhost:3000
```
---
## 📌 Future Improvements
- Authentication & Role-Based Access
- Doctor & Staff Management
- Pharmacy Module
- Laboratory Module
- Inventory Management
- Notifications
- Docker Deployment
- PostgreSQL Support
- Multi-Agent AI Workflow
---
## 💡 What I Learned
This project helped me gain practical experience with:
- Building full-stack applications using Next.js and FastAPI
- Designing modular software architecture
- Integrating Large Language Models into business workflows
- Building reusable backend services
- Creating modern responsive user interfaces
- Working with AI-assisted application design
---
## 👨💻 Author
**Harshit Dasari**
GitHub: https://github.com/harshit2005-rgb
---
## ⭐ Version
Current Release:
**v1.0.0**
