git404hub

what is tetheros fr?

trapzzy/tetheros — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · developerComplexity · 4/5LicenseSetup · moderate

tl;dr

A bootable Linux distribution for anonymous penetration testing that routes traffic through Tor with auto IP rotation and 90+ built-in security tools.

vibe map

mindmap
  root((Tether OS))
    What it does
      Boots into pentesting shell
      Routes traffic through Tor
      Rotates IP automatically
      Kill switch firewall
    Tech stack
      Python
      Linux kernel
      Tor
      Buildroot
    Use cases
      Anonymous security testing
      Digital forensics
      Wireless scanning
    Audience
      Security professionals

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 make with this?

VIBE 1

Boot a live anonymous testing environment for authorized penetration testing.

VIBE 2

Run reconnaissance, forensics, and web scanning commands from one shell.

VIBE 3

Automatically rotate the visible IP address every 60 seconds via Tor.

VIBE 4

Install the same shell as a desktop app on Windows, Linux, or macOS.

what's the stack?

PythonLinuxTorBuildrootiptables

how it stacks up fr

trapzzy/tetheros0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity4/54/54/5
Audiencedeveloperdeveloperresearcher

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

how do i run it?

Difficulty · moderate time til it works · 30min

Booting the ISO needs QEMU or a USB writer, while the desktop app needs Python 3.7+ installed.

Licensed under MIT, so anyone can use, modify, and redistribute it freely, including for commercial purposes, as long as the copyright notice is kept.

in plain english

Tether OS is a bootable Linux distribution built for anonymous penetration testing, meaning security professionals testing systems with permission. It routes all network traffic through the Tor anonymity network and automatically rotates its exit node every 60 seconds, so the visible IP address keeps changing. The whole system fits inside a 27 megabyte ISO file and runs entirely from RAM rather than needing to install anything to disk. It can also be installed as a regular desktop application on Windows, Linux, and macOS instead of booting it directly. Once running, users get a custom terminal shell styled after coding assistant interfaces, complete with a dark theme, animated startup screen, and a matrix style rain effect. The shell includes more than 90 built-in commands covering reconnaissance, exploitation, digital forensics, web scanning, wireless testing, and scheduled tasks, plus command piping and output redirection similar to a normal Linux terminal. It also has its own small virtual filesystem with familiar commands like cd, ls, cat, and mkdir, a scripting format for running saved command sequences, four color theme presets, and automatic session logging so past commands can be reviewed or a session state restored later. Underneath the shell sits a custom Linux kernel with a firewall rule that blocks any traffic that is not going through Tor, acting as a kill switch if the anonymity connection drops. Tor itself starts automatically at boot with its proxy service and control port active. The project can be run quickly inside the QEMU emulator for testing, written to a USB drive to boot on real hardware, or installed as a Python package for the desktop app version. The codebase is organized into a shell interface layer, a set of command modules grouped by purpose, and a lower kernel layer handling Tor control and IP rotation. It is released under the MIT license.</content>

prompts (copy fr)

prompt 1
Explain how the Tor IP rotation and kill switch work together in this project.
prompt 2
Walk me through booting the ISO in QEMU for a quick test.
prompt 3
What command modules are included and what does each one cover?
prompt 4
How is the virtual filesystem implemented inside the shell?

Frequently asked questions

what is tetheros fr?

A bootable Linux distribution for anonymous penetration testing that routes traffic through Tor with auto IP rotation and 90+ built-in security tools.

What language is tetheros written in?

Mainly Python. The stack also includes Python, Linux, Tor.

What license does tetheros use?

Licensed under MIT, so anyone can use, modify, and redistribute it freely, including for commercial purposes, as long as the copyright notice is kept.

How hard is tetheros to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is tetheros for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.