shreecodes216/DisasterShieldAI
GitHub: shreecodes216/DisasterShieldAI
DisasterShieldAI 是一个基于 Google ADK 与 Gemini 模型的 AI 应急响应协调代理,能将灾害报告自动转化为包含资源计算、避难所推荐和优先级评估的结构化响应方案。
Stars: 0 | Forks: 0
# 🌍 DisasterShieldAI
## 📌 概述
DisasterShieldAI 是一个智能应急响应助手,能够分析灾害报告并立即生成协调一致的灾害响应计划。
该智能体会识别灾害类型,评估其严重程度,计算所需的应急资源,推荐临时避难所,分配响应优先级,并提供切实可行的公共安全建议。
其目标是协助灾害管理部门在紧急情况下做出更快、更明智的决策。
## 🚀 功能特性
- 🌊 检测多种灾害类型
- 洪水
- 地震
- 火灾
- 飓风
- 山体滑坡
- 化学品泄漏
- 热浪
- 海啸
- 建筑倒塌
- 工业事故
- 📊 评估
- 灾害严重程度
- 受灾人口
- 🚑 计算应急资源
- 食品包
- 医疗包
- 救援队
- 救护车
- 医生
- 志愿者
- 船只
- 直升机
- 消防车
- 🏫 推荐避难所方案
- 避难所类型
- 避难所数量
- 所需容量
- 🚨 分配响应优先级
- 🔴 紧急
- 🟠 高
- 🟡 中
- 🟢 低
- 📋 生成完整的灾害响应报告
# 🛠 技术栈
| 类别 | 技术 |
|-----------|------------|
| 语言 | Python 3.13 |
| AI 框架 | Google Agent Development Kit (ADK) |
| LLM | Gemini 3.5 Flash |
| 后端 | Python |
| 运行环境 | PowerShell / Windows |
| 版本控制 | Git & GitHub |
# 📂 项目结构
```
DisasterShieldAI
│
├── disaster_shield_ai
│ │
│ ├── agent.py
│ ├── __init__.py
│ │
│ ├── tools
│ │ ├── incident_tool.py
│ │ ├── resource_tool.py
│ │ ├── shelter_tool.py
│ │
│ └── .env
│
├── requirements.txt
├── README.md
└── .gitignore
```
# ⚙️ 工作原理
该 AI agent 遵循以下工作流程:
```
User Disaster Report
│
▼
Analyze Incident Tool
│
▼
Identify
• Disaster Type
• Severity
• Population
│
▼
Resource Calculation Tool
│
▼
Shelter Recommendation Tool
│
▼
Gemini AI
│
▼
Disaster Response Report
```
# 📋 示例输入
```
Flood in Howrah.
500 people stranded.
Roads blocked.
```
# 📋 示例输出
```
Disaster Type: Flood
Severity: High
Priority Level: 🔴 Critical
Affected Population: 500
Resources Required
• Food Kits: 500
• Medical Kits: 500
• Rescue Teams: 5
• Ambulances: 10
• Doctors: 5
• Volunteers: 20
• Boats: 3
Shelter Recommendation
Government School
2 Shelters
Capacity: 500
Emergency Response Plan
• Evacuate stranded civilians
• Deploy rescue boats
• Set up medical camps
• Distribute relief materials
• Activate temporary shelters
Public Safety Recommendations
• Avoid floodwaters
• Move to higher ground
• Drink boiled water
• Follow official advisories
```
# ▶️ 安装说明
克隆仓库
```
git clone https://github.com/YOUR_USERNAME/DisasterShieldAI.git
```
进入项目目录
```
cd DisasterShieldAI
```
安装依赖项
```
pip install -r requirements.txt
```
创建 `.env` 文件
```
GOOGLE_API_KEY=YOUR_API_KEY
```
运行 ADK Web 界面
```
adk web
```
打开
```
http://127.0.0.1:8000
```
# 📸 演示
https://youtu.be/ZPION3SMUp0
# 📷 截图
# 🎯 未来改进
- 接入实时天气 API
- GIS 地图可视化
- 短信和电子邮件紧急警报
- 医院资源可用性跟踪
- 实时避难所占用情况
- 多语言支持
- 使用 ML 模型进行灾害预测
- 与政府紧急服务集成
# 👩💻 开发者
**Somoshree Pal**
_ECE 本科生_
# 📜 许可证
本项目基于 MIT 许可证授权。
# 🎯 未来改进
- 接入实时天气 API
- GIS 地图可视化
- 短信和电子邮件紧急警报
- 医院资源可用性跟踪
- 实时避难所占用情况
- 多语言支持
- 使用 ML 模型进行灾害预测
- 与政府紧急服务集成
# 👩💻 开发者
**Somoshree Pal**
_ECE 本科生_
# 📜 许可证
本项目基于 MIT 许可证授权。标签:Gemini, Google ADK, 人工智能, 应急协调, 灾害响应, 用户模式Hook绕过, 逆向工具