https://github.com/halaprix/medi-vault
https://github.com/halaprix/medi-vault
Last synced: 28 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/halaprix/medi-vault
- Owner: halaprix
- Created: 2026-05-14T19:32:49.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-14T21:13:07.000Z (2 months ago)
- Last Synced: 2026-05-14T22:37:45.705Z (2 months ago)
- Language: Python
- Size: 72.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
# medi-vault
Your personal health data vault. Upload medical test results, track biomarkers over time, and get AI-powered insights — all local and private.
## Quick Start
```bash
cp .env.example .env
docker compose up -d
```
Then visit `http://localhost:3005`.
## Architecture
- **Backend**: FastAPI (Python) — REST API + async task processing
- **Frontend**: Next.js 14 (TypeScript) — App Router + Tailwind CSS
- **Database**: PostgreSQL — encrypted health data storage
- **Vector DB**: ChromaDB — medical knowledge retrieval (RAG)
- **LLM**: Ollama — local document parsing (no data leaves your machine)
- **OCR**: PaddleOCR / DocTR — extract text from PDF/image lab results
## Features
- Upload PDF/image lab results → automatic OCR + LLM extraction
- Track 80+ biomarkers with reference ranges
- Trend visualization (weight, cholesterol, glucose, etc.)
- Google Fit sync (weight, steps, sleep, heart rate)
- RAG-powered health recommendations based on medical guidelines
- Full encryption at rest (Fernet)
- PIN-protected local access
## Development
```bash
make up # Start all services
make migrate # Run database migrations
make seed # Load biomarker reference data
make ingest-rag # Populate knowledge base into ChromaDB
make test # Run all tests
```
## License
MIT