Real-time Blood Alert System
HaemoLogix connects verified hospitals to nearby, eligible blood donors — filtered by blood group, urgency, and location.
Hospitals raise an alert, donors accept in one tap, and donations are tracked with history, eligibility, and analytics.
Because minutes matter. Every second counts when it comes to saving lives. 💉
- 🌐 Live Application - Try HaemoLogix now
- 🎥 Demo Video - Watch it in action
- 📊 Presentation - Project overview
- 📖 Documentation - Detailed guides
- 🤝 Contributing Guide - How to contribute
- 📜 Code of Conduct - Community standards
- 🔒 Security Policy - Report vulnerabilities
- Instant Alert Creation - Raise blood requests in seconds with urgency levels
- Smart Donor Matching - AI-powered geolocation-based donor matching
- Real-time Tracking - Monitor alert status and responses live
- Verified System - Document-based hospital verification with OCR
- Analytics Dashboard - Track donation history and inventory levels
- One-Tap Response - Accept or decline requests instantly
- Eligibility Tracking - Automated eligibility calculations based on WHO guidelines
- Donation History - Complete record of all donations
- Smart Notifications - SMS and email alerts for nearby requests
- Privacy First - Control your visibility and notification preferences
- Verification Workflow - Approve hospitals and donors with AI assistance
- System Monitoring - Real-time agent logs and system health
- Analytics & Insights - Platform-wide metrics and trends
- User Management - Comprehensive admin controls
- AI Agent System - 6 intelligent agents (Coordinator, Donor, Hospital, Inventory, Logistics, Screening)
- Event-Driven Architecture - Scalable and resilient system design
- Machine Learning - Demand forecasting and intelligent matching
- Geospatial Queries - Efficient radius-based donor search
- Multi-Channel Notifications - SMS (Twilio) + Email (SMTP)
- Document Processing - OCR for automatic data extraction
- QR Code Integration - Quick donor onboarding
- Framework: Next.js 15 (App Router)
- Language: TypeScript 5
- Styling: Tailwind CSS
- UI Components: Radix UI + shadcn/ui
- Icons: Lucide React
- Animations: GSAP
- Forms: React Hook Form + Zod validation
- Charts: Recharts
- Maps: Google Maps API
- Runtime: Node.js 18+
- API: Next.js Server Actions & API Routes
- Database: PostgreSQL (NeonDB)
- ORM: Prisma
- Authentication: Clerk
- File Storage: AWS S3
- Notifications: Twilio (SMS) + Nodemailer (Email)
- Geocoding: Nominatim + OpenCage
- OCR: Tesseract.js
- Document Processing: pdf-lib, pdf-parse, sharp
- ML Models: Custom training pipeline (PyTorch)
- Inference: Hugging Face API
- LLM: Claude 4.5 Sonnet (via OpenRouter)
- Hosting: Vercel
- CI/CD: GitHub Actions (via Vercel)
- Analytics: Vercel Analytics
- Monitoring: Custom agent logging system
📚 For detailed tech stack information, see TECHSTACK.md
HaemoLogix uses an event-driven microservice architecture powered by AI agents:
- Coordinator Agent: Orchestrates system-wide events
- Donor Agent: Matches and notifies eligible donors
- Hospital Agent: Processes alerts and requests
- Inventory Agent: Monitors blood stock levels
- Logistics Agent: Coordinates donation logistics
- Screening Agent: AI-powered document verification
All agents communicate via an event bus, ensuring scalability and fault tolerance.
- SWOT Analysis - Strategic analysis
- Donor Eligibility Criteria - WHO-based guidelines
- Hospital Eligibility Criteria - Verification requirements
- Agent System - AI agent architecture and implementation
- Agent Testing Guide - How to test agents
- Tech Stack Details - Comprehensive technology overview
- ML Training Guide - Machine learning pipeline
- CI/CD Pipeline - Workflows and security scanning
- Privacy Policy - Data protection information
- Terms & Conditions - Usage terms
- Node.js 18+ and npm/pnpm
- PostgreSQL database (we recommend NeonDB)
- Git
git clone https://github.com/Aftab48/Haemologix.app.git
cd haemologixnpm install
# or
pnpm installCopy the example environment file and fill in your credentials:
cp .example.env .env.localRequired environment variables:
- Clerk (Authentication): Get keys from clerk.com
- NeonDB (Database): Get connection string from neon.tech
- Twilio (SMS): Get credentials from twilio.com
- AWS S3 (File Storage): Configure S3 bucket
- SMTP (Email): Configure email service
- OpenCage (Geocoding): Get API key from opencagedata.com
See .example.env for all required variables.
npx prisma generate
npx prisma db pushnpm run devOpen http://localhost:3000 to see the application.
npm run generate:data
npm run export:datacd ml
# Follow instructions in ml/README.mdWe recommend deploying via Vercel for the best experience:
- Connect your GitHub repository to Vercel
- Configure environment variables in the Vercel dashboard
- Deploy! Vercel will automatically build and deploy your app
Make sure to set all required environment variables in your deployment platform. See .example.env for the complete list.
We welcome contributions from the community! HaemoLogix is open source and built with ❤️ for saving lives.
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'feat: Add AmazingFeature') - Push to your branch (
git push origin feature/AmazingFeature) - Open a Pull Request
We especially welcome contributions in:
- 🧪 Test coverage - Unit tests, integration tests
- 🌍 Internationalization - Hindi, Bengali, Tamil, Telugu translations
- ♿ Accessibility - ARIA labels, keyboard navigation
- 📱 Mobile app - React Native development
- 🤖 ML improvements - Better forecasting models
- 📝 Documentation - Guides, tutorials, API docs
Please read our Contributing Guide for detailed information on:
- Code style and standards
- Commit message conventions
- Pull request process
- Testing requirements
- Documentation standards
Important: All contributors are expected to follow our Code of Conduct to ensure a welcoming and inclusive community.
Security is critical for a healthcare application. If you discover a security vulnerability, please follow our Security Policy.
Do NOT open a public issue for security vulnerabilities.
Report security issues to: mdalam4884@gmail.com
This project is licensed under the MIT License - see the LICENSE file for details.
Copyright (c) 2025 Haemologix Private Limited
HaemoLogix is developed and maintained by Haemologix Private Limited.
-
Aftab Alam - Lead Developer & Co-Founder
-
Ayushi Mandal - Developer & Co-Founder
We're grateful to all contributors who help make HaemoLogix better!
- 🐛 Report a Bug
- ✨ Request a Feature
- 💬 Join Discussions
- 📧 Email: mdalam4884@gmail.com
- ⭐ Star this repo if you find it useful!
- 🐦 Share HaemoLogix with your network
- 🤝 Contribute to make it better
- ✅ Version: 0.5.1
- ✅ Status: Active Development
- ✅ Production: Live at haemologix.vercel.app
- ✅ License: MIT (Open Source)
See CHANGELOG.md for version history and future roadmap.
- Machine learning model deployment
- Multi-language support
- Mobile application (React Native)
- Government health database integration
- Advanced analytics dashboard
If HaemoLogix helps your organization or inspires your project, please:
- ⭐ Star this repository
- 🔄 Share it with others
- 🤝 Contribute to the project
- 💬 Spread the word about efficient blood donation
Try HaemoLogix Now | Documentation | Contributing
Made with ❤️ for humanity | Copyright © 2025 Haemologix Private Limited | MIT License