Skillget

USB-AI-Agent

agent
Security Audit
Fail
Health Warn
  • No license — Repository has no license file
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 9 GitHub stars
Code Fail
  • rm -rf — Recursive force deletion command in Linux/install.sh
  • exec() — Shell command execution in Shared/agent.py
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

🔌 Portable uncensored AI agent that runs from USB/SSD. 13 autonomous tools (deep search, OSINT, code execution), persistent memory, 5 GGUF models, zero install, zero traces. Cross-platform (Windows + Linux).

README.md

USB AI Agent — Portable Uncensored AI + Autonomous Agent

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.

USB AI Agent — startup banner with a live Ollama connection

🔥 What Makes This Different

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

🚀 Quick Start

Windows

# First time: install engine + models
Windows\install.bat

# Every time: launch the agent
Windows\start-agent.bat

Linux (including Tails)

# First time: install engine + models
bash Linux/install.sh

# Every time: launch the agent
bash Linux/start-agent.sh

A local web chat UI ships alongside the CLI (Linux/start.sh / Windows/start-fast-chat.bat) — no cloud, no account:

USB AI Agent — local web chat UI

🛠️ Available Tools

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

🧠 Models Included

Pre-configured for 5 uncensored GGUF models (~25GB total):

  1. Gemma 2 2B Abliterated (~1.7 GB) — Blazing fast, recommended for all
  2. Gemma 4 E4B Ultra Uncensored (~5.3 GB) — Maximum compliance
  3. Qwen 3.5 9B Uncensored (~5.6 GB) — Best for agent/tool calling
  4. NemoMix Unleashed 12B (~7.5 GB) — Heavyweight reasoning
  5. Dolphin 2.9 Llama 3 8B (~4.9 GB) — Classic uncensored

Models are downloaded once and work on any OS without re-downloading.

💻 Requirements

  • 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)

📂 Architecture

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
│   ├── FastChatUI.html      # The web chat interface it serves
│   ├── python/              # Auto-downloaded portable Python
│   ├── bin/                 # Portable Ollama engine
│   └── models/              # GGUF model files
└── .gitignore

🔒 Privacy

  • 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

📱 Android Apps

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.

🙏 Credits

Built on top of USB-Uncensored-LLM by Tech Jarves.

OSINT tools: Holehe, Maigret, Agent Reach.

🔗 More from Pusu

Project Description
🛡️ Pusu AdBlocker Chrome MV3 ad blocker — 35,000+ rules, zero tracking
🌐 AI-Flight-Search AI-powered flight search engine
💡 ZENO AI project — details coming soon

⚖️ License

MIT — same as the original project.

Reviews (0)

No results found