lavanya8688049068/GuardianHer-AI-Womens-Safety

# GuardianHer AI ## 概述 GuardianHer AI 是一个统一的安全生态系统，可在紧急情况**发生前**、**发生时**和**发生后**为女性提供保护，具体通过以下方式实现： - **主动威胁检测** — IBM watsonx.ai 生物特征异常评分 - **即时 SOS 调度** — 3秒内多渠道警报（SMS、呼叫、推送） - **安全路线智能** — 犯罪热力图 + AI 排序的导航 - **事件后 AI 助手** — 用于恢复和提交报告的 IBM Watson Assistant - **证据保全** — 带有完整性哈希的 AES-256 加密保险库 ## 使用的 IBM 技术 | 服务 | 用途 | |---|---| | IBM watsonx.ai | 威胁评分模型，生物特征异常检测 | | IBM Watson NLP | 求助关键字检测，情感分析 | | IBM Watson STT/TTS | 语音 SOS 检测，多语言音频警报 | | IBM Watson Assistant | 事件后 AI 助手聊天机器人 | | IBM IoT Platform | 可穿戴设备传感器流数据摄入 (MQTT) | | IBM Cloud Object Storage | 加密证据保险库 | | IBM App ID | OAuth 2.0 身份验证和 RBAC | | IBM AI Fairness 360 | 对威胁模型进行持续偏见审计 | ## 项目结构 ``` guardianher-ai/ ├── app.py # Streamlit entry point ├── requirements.txt # Python dependencies ├── .env.example # Environment variable template │ ├── config/ # Configuration layer ├── core/ # Shared core utilities and base classes ├── pages/ # Streamlit page modules (one per screen) ├── services/ # Business logic orchestration layer ├── modules/ # Functional feature modules (AI, maps, etc.) ├── database/ # Data access layer (repositories + schema) ├── ui/ # Reusable UI components and theme ├── assets/ # Static files (images, CSS, audio) ├── data/ # Local data files (SQLite DB, sample data) └── docs/ # Architecture diagrams and documentation ``` ## 快速开始 ### 1. 克隆并配置环境 ``` git clone https://github.com/your-team/guardianher-ai.git cd guardianher-ai python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate pip install -r requirements.txt ``` ### 2. 配置环境变量 ``` cp .env.example .env # 编辑 .env 并填写您的 IBM 服务凭证 ``` ### 3. 运行应用程序 ``` streamlit run app.py ``` ## 环境变量 请查看 [`.env.example`](.env.example) 获取所需变量的完整列表。 ## 架构 请查看 [`docs/`](docs/) 了解： - 系统架构文档 - 技术栈文档 - 软件架构文档 - 产品设计文档 (PRD) ## 团队 IBM Hackathon 2026 — GuardianHer AI 团队 ## 许可证 MIT 许可证 — 详情请参阅 LICENSE 文件。

标签：IBM watsonx, Kubernetes, 个人安全, 人工智能, 物联网, 生物识别, 用户模式Hook绕过, 紧急响应, 逆向工具