gitwtfhub

wtf is usb-ai-agent?

pusucip25/usb-ai-agent — explained in plain English

Analysis updated 2026-07-25

2PythonAudience · ops devopsComplexity · 4/5Setup · moderate

TL;DR

A portable, private AI assistant that runs entirely from a USB drive. It works offline, leaves no traces on the host computer, and includes 13 built-in tools for research, OSINT, and file management.

Mindmap

mindmap
  root((repo))
    What it does
      Runs from USB drive
      Offline AI assistant
      Leaves no traces
    Tools and Features
      Web search and research
      OSINT email and username lookup
      File and shell management
    Tech and Hardware
      Python
      Preconfigured AI models
      USB 3.0 drive and 8GB RAM
    Privacy
      No accounts or telemetry
      Chat saved to USB only
    Use Cases
      Portable AI assistant
      OSINT investigations
      Offline research agent

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run a private AI assistant on any computer from a USB drive.

REASON 2

Investigate email addresses and usernames across hundreds of platforms.

REASON 3

Perform multi-step web research and synthesize findings offline.

REASON 4

Use one of three included Android apps for companionship or flight search.

What's in the stack?

PythonOllamaDuckDuckGo

How it stacks up

pusucip25/usb-ai-agent0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity4/52/52/5
Audienceops devopsgeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 1h+

Requires a USB 3.0 drive or SSD with at least 30 GB of free space and a computer with 8-16 GB of RAM to run the preconfigured models.

Wtf does this do

This project packages a portable AI system that runs entirely from a USB drive or external SSD. The idea is simple: plug the drive into any Windows or Linux computer, run one script, and you have a fully functional AI assistant that leaves no traces on the host machine. It builds on an earlier project called USB-Uncensored-LLM, which only offered a chat interface. This version adds something more ambitious, an autonomous agent that can take actions rather than just answer questions. The agent comes with 13 built-in tools that the AI model decides how to use on its own. These tools fall into several categories. For searching, it can query the web through DuckDuckGo, fetch and read webpages, and perform multi-step research by searching, downloading, and synthesizing information from multiple sources. For OSINT work, which means gathering publicly available information, it can check which websites an email address is registered on, search for a username across over 600 platforms, and scan 15 social networks at once. It can also read and write files, list directory contents, execute shell commands, run Python code, and save information to persistent memory that survives across sessions. The project ships with five preconfigured AI models ranging from 1.7 GB to 7.5 GB in size, totaling about 25 GB. These are "uncensored" models, meaning they have fewer built-in restrictions on what they will discuss. You need a USB 3.0 drive or SSD with at least 30 GB of free space and a computer with 8 GB of RAM minimum, or 16 GB recommended for the larger models. Everything runs offline after the initial download, with no accounts, no telemetry, and no tracking. Chat history saves only to the USB drive itself. The repo also includes three standalone Android apps, an AI companion called Blu, an improved companion called ZENO, and an AI-powered flight search app.

Yoink these prompts

Prompt 1
How do I install and run the USB AI Agent on my flash drive, and what are the minimum hardware requirements?
Prompt 2
Explain how the autonomous agent decides which of its 13 built-in tools to use when I ask it a question.
Prompt 3
How can I use the OSINT tools to find which social networks a specific username is registered on?
Prompt 4
How do I switch between the five preconfigured AI models included on the USB drive?

Frequently asked questions

wtf is usb-ai-agent?

A portable, private AI assistant that runs entirely from a USB drive. It works offline, leaves no traces on the host computer, and includes 13 built-in tools for research, OSINT, and file management.

What language is usb-ai-agent written in?

Mainly Python. The stack also includes Python, Ollama, DuckDuckGo.

How hard is usb-ai-agent to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is usb-ai-agent for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.