https://github.com/techfreak2003/bia
BIA (Blood Report Insights Agent) - AI Agent to analyze blood reports and provide detailed health insights.
https://github.com/techfreak2003/bia
ai aiagent grok llama3 llama3-70b-8192 pdfplumber python streamlit supabase supabase-auth
Last synced: 4 months ago
JSON representation
BIA (Blood Report Insights Agent) - AI Agent to analyze blood reports and provide detailed health insights.
- Host: GitHub
- URL: https://github.com/techfreak2003/bia
- Owner: TechFreak2003
- License: mit
- Created: 2025-05-06T16:55:38.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-05-25T16:42:57.000Z (5 months ago)
- Last Synced: 2025-06-03T11:37:46.229Z (4 months ago)
- Topics: ai, aiagent, grok, llama3, llama3-70b-8192, pdfplumber, python, streamlit, supabase, supabase-auth
- Language: Python
- Homepage:
- Size: 136 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 🩺 BIA (Blood Report Insights Agent)
AI Agent will 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: LLaMA-3.3-70B-Versatile
- Secondary: LLaMA-3-8B-8192
- Tertiary: Mixtral-8x7B-32768
- Fallback: Gemma-7B-IT
- **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:
```bash
git clone https://github.com/TechFreak2003/hia.git
cd hia
```
2. Install dependencies:
```bash
pip install -r requirements.txt
```
3. Required environment variables (in `.streamlit/secrets.toml`):
```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 confirmation on signup in Supabase settings -> signup -> email)
5. Run the application:
```bash
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](CONTRIBUTING.md) 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 |
|--------|------|--------|------|---------------|
| 
| Suvrodeep Das | [TechFreak2003](https://github.com/TechFreak2003) | Project Creator & Maintainer | Core implementation, Documentation |
## 📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
## 🙋♂️ Author
Created by [Suvrodeep Das](https://suvrodeepdas.dev)