shaunbny/PhiShield-ai
GitHub: shaunbny/PhiShield-ai
一款基于 AI 和 RAG 技术的多模态钓鱼检测系统，可分析 URL、文本、截图和语音中的安全威胁并提供实时风险解释与处置建议。
Stars: 0 | Forks: 0
# 图片
# 🚀 快速开始
## 前置条件
在运行项目之前，请确保您已安装：
- Python 3.10 或更高版本
- Git
- Tesseract OCR
- PyTorch（EasyOCR 必需；通过 pip 自动安装）
### 安装 Tesseract OCR
**Windows**
从以下地址下载并安装：
https://github.com/UB-Mannheim/tesseract/wiki
安装后，如有必要，请更新 `frontend.py` 中的路径：
```
pytesseract.pytesseract.tesseract_cmd = r"C:\Program Files\Tesseract-OCR\tesseract.exe"
```
对于 Linux：
```
sudo apt update
sudo apt install tesseract-ocr
```
对于 macOS：
```
brew install tesseract
```
# 📥 克隆仓库
```
git clone https://github.com/shaunbny/PhiShield-ai.git
cd PhishShield-AI
```
# 🐍 创建虚拟环境
### Windows
```
python -m venv venv
venv\Scripts\activate
```
### Linux/macOS
```
python3 -m venv venv
source venv/bin/activate
```
# 📦 安装依赖
```
pip install -r requirements.txt
```
如果没有 `requirements.txt` 文件，请手动安装所需的包：
```
pip install fastapi uvicorn gradio requests pillow pytesseract easyocr python-dotenv groq langchain langchain-core langchain-community langchain-huggingface langchain-text-splitters langchain-groq faiss-cpu sentence-transformers
```
# 🔑 配置环境变量
在项目根目录下创建一个名为 `.env` 的文件。
```
GROQ_API_KEY=YOUR_GROQ_API_KEY
BACKEND_URL=http://127.0.0.1:8000/api/analyze
```
您可以从以下地址获取免费的 Groq API key：
https://console.groq.com/keys
# ▶ 运行应用程序
## 步骤 1 — 启动后端
在项目文件夹中打开一个终端。
```
python backend.py
```
如果成功，您将看到类似于以下的内容：
SUCCESS: Balanced RAG core pipeline built successfully!Uvicorn running on http://127.0.0.1:8000
保持此终端运行。
## 步骤 2 — 启动前端
打开另一个终端。
导航到项目文件夹。
如有必要，请再次激活虚拟环境。
运行：
```
python frontend.py
```
应用程序将启动于：
http://127.0.0.1:7860
在浏览器中打开该 URL。
# 🧪 使用 PhiShield AI
应用程序接受多种输入类型：
- 粘贴可疑的 URL
- 粘贴电子邮件或 SMS 文本
- 上传屏幕截图以进行 OCR 分析（由 EasyOCR 和 Tesseract 提供支持）
- 上传或录制语音备忘录
点击 **Analyze Security Legitimacy** 以接收：
- 威胁分类
- AI 推理
- 建议操作
- 官方举报渠道
# 🛑 停止应用程序
要停止应用程序，请按：
## CTRL + C
在两个终端窗口中分别执行。
# 🔄 更新项目
```
git pull
pip install -r requirements.txt
```
# 🚀 快速开始
## 前置条件
在运行项目之前，请确保您已安装：
- Python 3.10 或更高版本
- Git
- Tesseract OCR
- PyTorch（EasyOCR 必需；通过 pip 自动安装）
### 安装 Tesseract OCR
**Windows**
从以下地址下载并安装：
https://github.com/UB-Mannheim/tesseract/wiki
安装后，如有必要，请更新 `frontend.py` 中的路径：
```
pytesseract.pytesseract.tesseract_cmd = r"C:\Program Files\Tesseract-OCR\tesseract.exe"
```
对于 Linux：
```
sudo apt update
sudo apt install tesseract-ocr
```
对于 macOS：
```
brew install tesseract
```
# 📥 克隆仓库
```
git clone https://github.com/shaunbny/PhiShield-ai.git
cd PhishShield-AI
```
# 🐍 创建虚拟环境
### Windows
```
python -m venv venv
venv\Scripts\activate
```
### Linux/macOS
```
python3 -m venv venv
source venv/bin/activate
```
# 📦 安装依赖
```
pip install -r requirements.txt
```
如果没有 `requirements.txt` 文件，请手动安装所需的包：
```
pip install fastapi uvicorn gradio requests pillow pytesseract easyocr python-dotenv groq langchain langchain-core langchain-community langchain-huggingface langchain-text-splitters langchain-groq faiss-cpu sentence-transformers
```
# 🔑 配置环境变量
在项目根目录下创建一个名为 `.env` 的文件。
```
GROQ_API_KEY=YOUR_GROQ_API_KEY
BACKEND_URL=http://127.0.0.1:8000/api/analyze
```
您可以从以下地址获取免费的 Groq API key：
https://console.groq.com/keys
# ▶ 运行应用程序
## 步骤 1 — 启动后端
在项目文件夹中打开一个终端。
```
python backend.py
```
如果成功，您将看到类似于以下的内容：
SUCCESS: Balanced RAG core pipeline built successfully!Uvicorn running on http://127.0.0.1:8000
保持此终端运行。
## 步骤 2 — 启动前端
打开另一个终端。
导航到项目文件夹。
如有必要，请再次激活虚拟环境。
运行：
```
python frontend.py
```
应用程序将启动于：
http://127.0.0.1:7860
在浏览器中打开该 URL。
# 🧪 使用 PhiShield AI
应用程序接受多种输入类型：
- 粘贴可疑的 URL
- 粘贴电子邮件或 SMS 文本
- 上传屏幕截图以进行 OCR 分析（由 EasyOCR 和 Tesseract 提供支持）
- 上传或录制语音备忘录
点击 **Analyze Security Legitimacy** 以接收：
- 威胁分类
- AI 推理
- 建议操作
- 官方举报渠道
# 🛑 停止应用程序
要停止应用程序，请按：
## CTRL + C
在两个终端窗口中分别执行。
# 🔄 更新项目
```
git pull
pip install -r requirements.txt
```
标签：AI安全, AV绕过, Chat Copilot, DLL 劫持, FastAPI, Sysdig, URL分析, 凭据扫描, 大语言模型, 威胁情报, 开发者工具, 逆向工具, 钓鱼检测