Files
turboquant/resources/crisis_resources.json
Alexander Payne 16e73dd143
All checks were successful
Smoke Test / smoke (pull_request) Successful in 11s
feat(edge-crisis): add complete offline crisis detection deployment for edge devices
Deliverables for issue #102:

1. Deployment guide: docs/edge-crisis-deployment.md (11KB)
   - Hardware targets: Raspberry Pi 4, Android Termux, old laptops
   - Model selection: Bonsai-1.7B (primary, F1 0.86), Falcon-H1-Tiny-90M (fallback, 300MB)
   - TurboQuant integration: llama-cpp-turboquant build + turbo4 KV compression
   - Offline resource cache: 988 phone/text, Crisis Text Line (741741), SAMHSA, Trevor Project
   - Crisis detection wrapper script + troubleshooting guide

2. Edge device profile: profiles/edge-crisis.yaml
   - Hermes profile for local llama.cpp server with TurboQuant
   - turbo4 compression on keys and values
   - Minimal offline-only toolset (memory, read_file, write_file)
   - Platform tuning: Pi 4 (4 threads), Android Termux (2 threads)

3. Offline resource cache: resources/crisis_resources.json
   - Hotline database with multiple national services
   - Local resource discovery pattern
   - Self-care steps for acute crisis management

4. Offline test script: tests/test_edge_crisis_offline.sh
   - End-to-end verification: prerequisites, server startup, health check
   - Offline validation guidance (user performs network disconnect)
   - Resource cache integrity check
   - Clean bash-n syntax

Model rationale: Bonsai-1.7B (1.1GB GGUF Q4) runs ~8 tok/s on Pi 4 with TurboQuant
turbo4 reducing KV cache from 8GB to 2.2GB, enabling 8K context on 4GB RAM devices.
Falcon-H1-Tiny-90M (300MB) serves severely constrained hardware (<2GB RAM).

Closes #102
2026-04-29 00:05:43 -04:00

57 lines
2.2 KiB
JSON

{
"version": "1.0",
"generated": "2026-04-29T00:00:00Z",
"source": "Timmy Foundation Crisis Deployment \u2014 Issue #102",
"hotlines": {
"988": {
"name": "988 Suicide & Crisis Lifeline",
"description": "24/7 free, confidential crisis support via phone and chat",
"phone": "988",
"chat_url": "https://988lifeline.org/chat/",
"tty": "1-800-799-4889",
"text": null,
"hours": "24/7",
"notes": "Also routes to Veterans Crisis Line (press 1)"
},
"crisis_text_line": {
"name": "Crisis Text Line",
"description": "Free 24/7 crisis support via text message",
"phone": null,
"sms": "741741",
"hours": "24/7",
"notes": "Text HOME to connect with a crisis counselor"
},
"samhsa": {
"name": "SAMHSA National Helpline",
"description": "Substance use and mental health referrals",
"phone": "1-800-662-4357",
"hours": "24/7",
"notes": "Confidential, free, in English and Spanish"
},
" Trevor_project": {
"name": "Trevor Project (LGBTQ+ Youth)",
"description": "Crisis intervention and suicide prevention for LGBTQ+ youth",
"phone": "1-866-488-7386",
"text": "START to 678678",
"hours": "24/7",
"notes": "Also available via chat at thetrevorproject.org/get-help"
}
},
"local": {
"find_local_help": "Search 'mental health crisis near me' and save results before going offline",
"example_county": {
"name": "San Francisco County Mental Health",
"phone": "(628) 654-7700",
"address": "San Francisco General Hospital, 1001 Potrero Ave",
"hours": "24/7 emergency"
}
},
"self_care_steps": [
"Call or text a crisis line \u2014 they are trained to help",
"Go to your nearest emergency room if in immediate danger",
"Remove means of self-harm from your immediate area if possible",
"Sit with a trusted person (friend, family, neighbor)",
"Practice box breathing: 4s inhale, 4s hold, 4s exhale, 4s hold (repeat)"
],
"offline_note": "This file is cached for offline use. Update quarterly when online by re-downloading from the Timmy Foundation crisis resources repository."
}