Health-Integrated-Servs-Home-Delivery/AI-COMP-SUD-ASSESSMENT-YOUTH

Subject: Scalable Digital Solution for Youth Substance Use ​Our design delivers a culturally grounded, privacy-preserving digital agent to transform substance use identification in South Africa. By integrating WHO standards with a clinically rigorous yet secure path to care. A scalable solution bon community engagement and human dignity. # AI-COMP-SUD-ASSESSMENT-YOUTH **Youth Substance Use Disorder (SUD) Assessment AI Agent** South Africa | Ages 12–35 | Culturally & Linguistically Inclusive | Blockchain-Secured | UTC/UPC Integrated --- ## Overview This repository contains the implementation of an AI-powered substance use assessment and referral agent for South African youth (ages 12–35). The agent integrates clinically validated screening with culturally adapted support across all 11 official South African languages. ### Key Features | Feature | Details | |---|---| | **Clinical Engine** | WHO ASSIST v3.0 — screens 10 substance categories with branching logic and real-time risk scoring | | **Risk Stratification** | Three-tier UPC/UTC model (Universal Prevention → Early Intervention → Treatment Referral) | | **Language Support** | All 11 official South African languages with empathetic, age-adaptive tone | | **Privacy** | Hybrid ECC + AES-256-GCM encryption; user holds private keys; SHA-256 blockchain proof-of-existence | | **Referral Engine** | Geolocation-aware matching to SANCA, DSD, Higher Health, Ke Moja, SADAG, and private services | | **Crisis Intervention** | Real-time keyword detection with immediate display of national crisis numbers | | **Platforms** | CLI (included); architecture is platform-agnostic for WhatsApp, USSD, web | --- ## Project Structure ``` src/ ├── assessment/ # WHO ASSIST v3.0 engine + UPC/UTC risk stratification │ ├── __init__.py # Questions, scoring, substance enums │ └── risk_stratification.py # 3-tier stratification + feedback builder ├── i18n/ │ └── __init__.py # 11-language UI strings framework ├── referral/ │ └── __init__.py # Service directory + matching engine ├── privacy/ │ └── __init__.py # ECC key generation, encryption, blockchain hashing ├── crisis/ │ └── __init__.py # Crisis keyword detection + emergency resources └── agent/ └── __init__.py # Conversational FSM agent + CLI runner tests/ ├── test_as …