README.md

metadata

title: HNTAI - Medical Data Extraction API
emoji: 📉
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
pinned: false

HNTAI - Scalable Medical Data Extraction API

This is a FastAPI-based scalable API for extracting and processing medical data from various document formats, aligned with "ChatGPT Version 3 - Scalable" architecture.

Features

• Document text extraction (PDF, DOCX, Images)
• Audio transcription
• Medical data extraction
• PHI (Protected Health Information) scrubbing with audit logging
• Text summarization with Redis caching
• PostgreSQL database integration for persistence
• Async processing for scalability
• Health endpoints (/live, /ready)
• Security features (non-root containers, secrets management, HIPAA compliance)

Architecture Alignment

Fully aligned with "ChatGPT Version 3 - Scalable":

• FastAPI for async API handling
• Redis for caching and PHI stats
• PostgreSQL for audit logs and data persistence
• Kubernetes deployment with security contexts
• Network policies and HIPAA compliance
• Prometheus monitoring
• Proper resource limits and health probes

Deployment Options

• Hugging Face Spaces: Lightweight Docker deployment (legacy)
• Kubernetes: Scalable production deployment with security features

Environment Variables

• DATABASE_URL: PostgreSQL connection string
• REDIS_URL: Redis connection string
• SECRET_KEY: Application secret key
• JWT_SECRET_KEY: JWT signing key

API Endpoints

• GET /health/live - Liveness health check
• GET /health/ready - Readiness health check
• GET /metrics - Prometheus metrics
• POST /generate_patient_summary - Generate comprehensive patient summaries (with streaming support)
• POST /upload - Upload and process medical documents
• GET /get_updated_medical_data - Retrieve processed medical data
• PUT /update_medical_data - Update medical data fields
• POST /transcribe - Transcribe audio files
• POST /extract_medical_data - Extract structured medical data
• POST /api/generate_summary - Generate text summaries
• POST /api/extract_medical_data_from_audio - Process audio recordings
• POST /api/patient_summary_openvino - Generate patient summaries using OpenVINO

Development

Code Quality

This project uses the following tools for code quality:

• Black: Code formatting
• isort: Import sorting
• flake8: Linting
• mypy: Type checking

Run quality checks:

black .
isort .
flake8 .
mypy .

Testing

Run tests with:

python -m pytest

For more details, check the API documentation at /docs, DEVELOPMENT.md for development guides, and DEPLOYMENT.md for deployment instructions.