explaingit

pusucip25/usb-ai-agent

Analysis updated 2026-07-25

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

TLDR

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

What do people build with it?

USE CASE 1

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

USE CASE 2

Investigate email addresses and usernames across hundreds of platforms.

USE CASE 3

Perform multi-step web research and synthesize findings offline.

USE CASE 4

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

What is it built with?

PythonOllamaDuckDuckGo

How does it compare?

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 get it running?

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.

In plain English

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.

Copy-paste 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

What 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.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.