pusucip25/USB-AI-Agent
GitHub: pusucip25/USB-AI-Agent
一款可从 U 盘/SSD 启动、跨平台零安装的便携式无审查 AI Agent,内置 5 个 GGUF 模型和 13 个自主工具,支持离线搜索、OSINT、代码执行与持久化记忆。
Stars: 2 | Forks: 0
# USB AI Agent — 便携式无审查 AI + 自主 Agent
## 🔥 有何不同
最初的 [USB-Uncensored-LLM](https://github.com/techjarves/USB-Uncensored-LLM)(现已归档)曾是一个出色的便携式聊天工具。**本项目更进一步** —— 它不仅仅是一个聊天工具,更是一个能真正“执行”操作的 **Agent**。
| 功能 | 原项目 | 本项目 |
|---------|----------|-------------|
| 聊天 | ✅ | ✅ |
| 网页搜索 | ❌ (失效) | ✅ DuckDuckGo Lite |
| 深度搜索(多来源) | ❌ | ✅ 获取 + 阅读 + 综合 |
| OSINT(邮箱查询) | ❌ | ✅ Holehe(121+ 站点) |
| OSINT(用户名搜索) | ❌ | ✅ Maigret(600+ 平台) |
| OSINT(社交搜索) | ❌ | ✅ Agent Reach(15 平台) |
| 文件操作 | ❌ | ✅ 读取/写入/列出 |
| 代码执行 | ❌ | ✅ Python + Shell |
| 持久化记忆 | ❌ | ✅ 自动保存至 USB |
| 跨平台 | 部分支持 | ✅ Windows + Linux |
| 自主工具调用 | ❌ | ✅ 模型自主决定使用哪些工具 |
## 🚀 快速开始
### Windows
```
# 首次使用:安装 engine + models
Windows\install.bat
# 每次使用:启动 agent
Windows\start-agent.bat
```
### Linux(包括 Tails)
```
# 首次使用:安装 engine + models
bash Linux/install.sh
# 每次使用:启动 agent
bash Linux/start-agent.sh
```
## 🛠️ 可用工具
该 Agent 拥有 **13 个**可自主使用的工具:
| 类别 | 工具 | 描述 |
|----------|------|-------------|
| 🔍 搜索 | `web_search` | 搜索网页 (DuckDuckGo Lite) |
| 🔍 搜索 | `deep_search` | 多来源研究(搜索 → 获取 → 综合) |
| 🔍 搜索 | `web_get` | 下载并提取任意网页 |
| 🕵️ OSINT | `osint_email` | 检查邮箱注册的网站(121+ 站点) |
| 🕵️ OSINT | `osint_username` | 跨 600+ 平台查找用户名 |
| 🕵️ OSINT | `osint_social` | 同时搜索 15 个社交平台 |
| 📁 文件 | `read_file` | 读取系统上的任意文件 |
| 📁 文件 | `write_file` | 创建或覆盖文件 |
| 📁 文件 | `list_files` | 列出目录内容 |
| ⚡ 执行 | `run_command` | 执行 shell 命令 |
| 🐍 执行 | `run_python` | 执行 Python 代码 |
| 🧠 记忆 | `remember` | 持久化保存信息 |
| 🧠 记忆 | `recall` | 获取已保存的信息 |
## 🧠 内置模型
预配置了 5 个无审查的 GGUF 模型(总计约 25GB):
1. **Gemma 2 2B Abliterated**(约 1.7 GB) — 极速运行,推荐所有人使用
2. **Gemma 4 E4B Ultra Uncensored**(约 5.3 GB) — 最大程度的服从性
3. **Qwen 3.5 9B Uncensored**(约 5.6 GB) — 最适合 Agent/工具调用
4. **NemoMix Unleashed 12B**(约 7.5 GB) — 重量级推理
5. **Dolphin 2.9 Llama 3 8B**(约 4.9 GB) — 经典无审查模型
模型只需下载一次,即可在任何操作系统上使用,无需重新下载。
## 💻 系统要求
- USB 3.0 U 盘或 SSD,需有 **30+ GB 可用空间**
- 宿主机 PC:最低 8 GB RAM(运行 9B/12B 模型推荐 16 GB)
- Linux:`python3`(大多数发行版已内置)
- Windows:无需任何依赖(首次运行时会自动下载便携版 Python)
## 📂 架构
```
USB-AI-Agent/
├── Windows/
│ ├── install.bat # Downloads Ollama + models
│ ├── start-agent.bat # 🆕 Launches the autonomous agent
│ └── start-fast-chat.bat # Original web chat UI
├── Linux/
│ ├── install.sh # Downloads Ollama Linux + models
│ ├── start-agent.sh # 🆕 Launches the agent
│ └── start.sh # Original web chat
├── Shared/
│ ├── agent.py # 🆕 The autonomous agent (13 tools)
│ ├── chat_server.py # Web chat server
│ ├── python/ # Auto-downloaded portable Python
│ ├── bin/ # Portable Ollama engine
│ └── models/ # GGUF model files
└── .gitignore
```
## 🔒 隐私
- 初次下载后,所有操作均**完全离线**运行
- 绝无数据离开你的设备(连网进行网页搜索时除外)
- 无账号、无遥测、无追踪
- 聊天记录**仅保存至你的 USB 驱动器**
- 支持 **Tails** 及其他注重隐私的 Linux 发行版
## 📱 Android 应用
本仓库还包含使用 Capacitor + React 构建的独立 Android 应用程序:
| 应用 | 文件 | 描述 |
|-----|------|-------------|
| 🛸 **Blu** | `android-apks/Blu-v1.0.apk` | AI 聊天伙伴 —— 你的个人 AI 伴侣 |
| 🤖 **ZENO** | `android-apks/ZENO-v1.3-fix.apk` | AI 伙伴 v1.3 —— 改进并修复后的 AI 伴侣 |
| ✈️ **AI 航班搜索** | `android-apks/AI-Flight-Search.apk` | AI 驱动的航班搜索应用 |
所有应用均基于 Capacitor(React + TypeScript)构建,可旁加载至任意 Android 设备。
## 🔗 更多 Pusu 项目
| 项目 | 描述 |
|---|---|
| [🛡️ Pusu AdBlocker](https://github.com/pusucip25/pusu-adblocker) | Chrome MV3 广告拦截器 —— 35,000+ 规则,零追踪 |
| [🌐 AI-Flight-Search](https://github.com/pusucip25/AI-Flight-Search) | AI 驱动的航班搜索引擎 |
| [💡 ZENO](https://github.com/pusucip25/ZENO) | AI 项目 —— 详情即将发布 |
## ⚖️ 许可证
MIT —— 与原项目保持一致。
标签:AI风险缓解, Cutter, ESC4, OSINT, 人工智能, 便携工具, 实时告警, 数据泄露, 本地大模型, 用户模式Hook绕过, 网络安全审计, 自主智能体, 逆向工具