🩺 HIA (Health Insights Agent)

AI Agent to analyze blood reports and provide detailed health insights.

Features | Tech Stack | Installation | Contributing | Author

🌟 Features

• Intelligent agent-based architecture with multi-model cascade system
• In-context learning from previous analyses and knowledge base building
• Medical report analysis with personalized health insights
• PDF upload, validation and text extraction (up to 20MB)
• Secure user authentication and session management
• Session history with report analysis tracking
• Modern, responsive UI with real-time feedback

🛠️ Tech Stack

• Frontend Framework: Streamlit
• AI Integration: Multi-model architecture via Groq
  • Primary: meta-llama/llama-4-maverick-17b-128e-instruct
  • Secondary: llama-3.3-70b-versatile
  • Tertiary: llama-3.1-8b-instant
  • Fallback: llama3-70b-8192
• Database: Supabase
• PDF Processing: PDFPlumber
• Authentication: Supabase Auth

🚀 Installation

Requirements 📋

• Python 3.8+
• Streamlit 1.30.0+
• Supabase account
• Groq API key
• PDFPlumber
• Python-magic-bin (Windows) or Python-magic (Linux/Mac)

Getting Started 📝

1. Clone the repository:

git clone https://github.com/harshhh28/hia.git
cd hia

2. Install dependencies:

pip install -r requirements.txt

3. Required environment variables (in .streamlit/secrets.toml):

SUPABASE_URL = "your-supabase-url"
SUPABASE_KEY = "your-supabase-key"
GROQ_API_KEY = "your-groq-api-key"

4. Set up Supabase database schema:

The application requires the following tables in your Supabase database:

You can use the SQL script provided at public/db/script.sql [link] to set up the required database schema.

(PS: You can turn off the email confimation on signup in Supabase settings -> signup -> email)

5. Run the application:

streamlit run src\main.py

📁 Project Structure

hia/
├── requirements.txt
├── README.md
├── src/
│   ├── main.py                 # Application entry point
│   ├── auth/                   # Authentication related modules
│   │   ├── auth_service.py     # Supabase auth integration
│   │   └── session_manager.py  # Session management
│   ├── components/             # UI Components
│   │   ├── analysis_form.py    # Report analysis form
│   │   ├── auth_pages.py       # Login/Signup pages
│   │   ├── footer.py          # Footer component
│   │   └── sidebar.py         # Sidebar navigation
│   ├── config/                # Configuration files
│   │   ├── app_config.py      # App settings
│   │   └── prompts.py         # AI prompts
│   ├── services/              # Service integrations
│   │   └── ai_service.py      # AI service integration
│   ├── agents/                # Agent-based architecture components
│   │   ├── agent_manager.py   # Agent management
│   │   └── model_fallback.py  # Model fallback logic
│   └── utils/                 # Utility functions
│       ├── validators.py      # Input validation
│       └── pdf_extractor.py   # PDF processing

👥 Contributing

Contributions are welcome! Please read our Contributing Guidelines for details on how to submit pull requests, the development workflow, coding standards, and more.

We appreciate all contributions, from reporting bugs and improving documentation to implementing new features.

👨‍💻 Contributors

Thanks to all the amazing contributors who have helped improve this project!

Avatar	Name	GitHub	Role	Contributions	PR(s)	Notes
	Harsh Gajjar	harshhh28	Project Creator & Maintainer	Core implementation, Documentation	N/A	Lead Developer
	Gaurav	gaurav98095	Contributor	DB Schema, bugs	#1, #5, #6, #7	Database Design, bugs

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙋‍♂️ Author

Created by Harsh Gajjar