Plug in. Run one script. Get a fully autonomous AI agent with 13 tools, deep search, OSINT, and persistent memory — all from a portable USB/SSD. Zero install, zero traces.
The original USB-Uncensored-LLM (now archived) was a great portable chat. This takes it further — it's not just a chat, it's an agent that can actually DO things.
| Feature | Original | This Project |
|---|---|---|
| Chat | ✅ | ✅ |
| Web Search | ❌ (broken) | ✅ DuckDuckGo Lite |
| Deep Search (multi-source) | ❌ | ✅ Fetches + reads + synthesizes |
| OSINT (email lookup) | ❌ | ✅ Holehe (121+ sites) |
| OSINT (username search) | ❌ | ✅ Maigret (600+ platforms) |
| OSINT (social search) | ❌ | ✅ Agent Reach (15 platforms) |
| File Operations | ❌ | ✅ Read/Write/List |
| Code Execution | ❌ | ✅ Python + Shell |
| Persistent Memory | ❌ | ✅ Auto-saves to USB |
| Cross-Platform | Partial | ✅ Windows + Linux |
| Autonomous Tool Calling | ❌ | ✅ Model decides which tools to use |
Windows\install.bat
Windows\start-agent.bat
bash Linux/install.sh
bash Linux/start-agent.sh
The agent has 13 tools it can use autonomously:
| Category | Tool | Description |
|---|---|---|
| 🔍 Search | web_search |
|
| Search the web (DuckDuckGo Lite) | ||
| 🔍 Search | deep_search |
|
| Multi-source research (search → fetch → synthesize) | ||
| 🔍 Search | web_get |
|
| Download and extract any webpage | ||
| 🕵️ OSINT | osint_email |
|
| Check where an email is registered (121+ sites) | ||
| 🕵️ OSINT | osint_username |
|
| Find a username across 600+ platforms | ||
| 🕵️ OSINT | osint_social |
|
| Search 15 social platforms simultaneously | ||
| 📁 Files | read_file |
|
| Read any file on the system | ||
| 📁 Files | write_file |
|
| Create or overwrite files | ||
| 📁 Files | list_files |
|
| List directory contents | ||
| ⚡ Exec | run_command |
|
| Execute shell commands | ||
| 🐍 Exec | run_python |
|
| Execute Python code | ||
| 🧠 Memory | remember |
|
| Save information persistently | ||
| 🧠 Memory | recall |
|
| Retrieve saved information |
Pre-configured for 5 uncensored GGUF models (~25GB total):
Gemma 2 2B Abliterated(~1.7 GB) — Blazing fast, recommended for all** Gemma 4 E4B Ultra Uncensored**(~5.3 GB) — Maximum compliance** Qwen 3.5 9B Uncensored**(~5.6 GB) — Best for agent/tool calling** NemoMix Unleashed 12B**(~7.5 GB) — Heavyweight reasoning** Dolphin 2.9 Llama 3 8B**(~4.9 GB) — Classic uncensored
Models are downloaded once and work on any OS without re-down.
- USB 3.0 drive or SSD with 30+ GB free - Host PC: 8 GB RAM minimum (16 GB recommended for 9B/12B models)
- Linux:
python3
(built-in on most distros) - Windows: nothing (auto-downloads portable Python on first run)
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
- Everything runs fully offline after initial download - Zero data leaves your machine (except web searches when online)
- No accounts, no telemetry, no tracking
- Chat history saves only to your USB drive - Works on Tails and other privacy-focused Linux distros
This repo also includes standalone Android applications built with Capacitor + React:
| App | File | Description |
|---|---|---|
| 🛸 Blu | ||
android-apks/Blu-v1.0.apk |
||
| AI talking friend — your personal AI companion | ||
| 🤖 ZENO | ||
android-apks/ZENO-v1.3-fix.apk |
||
| AI friend v1.3 — improved AI companion with fixes | ||
| AI Flight Search | ||
android-apks/AI-Flight-Search.apk |
||
| AI-powered flight search app |
All apps are Capacitor-based (React + TypeScript) and can be side-loaded on any Android device.
Built on top of USB-Uncensored-LLM by Tech Jarves.
OSINT tools: Holehe, Maigret, Agent Reach.
MIT — same as the original project.