malwaredllc /byob

An open-source post-exploitation framework for students, researchers and developers.

★ 9,521⑂ 2,138👁 316⑃ 236● 518▤ 0
PythonGPL-3.0Created 2017-12-18
+1
Daily
9,521
stars
2,138
forks
316
watchers
236
prs
518
issues
0
releases

README

!Banner





&url=https://github.com/malwaredllc/byob&via=malwaredllc&hashtags=byob,python,security,github)


Questions? Check out the docs or join our Discord support server

__Disclaimer__: This project should be used for authorized testing or educational purposes only.

BYOB is an open-source post-exploitation framework for students, researchers and developers. It includes features such as:
- Command & control server with intuitive user-interface
- Custom payload generator for multiple platforms
- 12 post-exploitation modules

It is designed to allow students and developers to easily implement their own code and add cool new
features without having to write a C2 server or Remote Administration Tool from scratch.

This project has 2 main parts: the original console-based application (/byob) and the web GUI (/web-gui).

 Web GUI

 Dashboard
A control panel for your C2 server with a point-and-click interface for executing post-exploitation modules. The control panel includes an interactive map of client machines and a dashboard which allows efficient, intuitive administration of client machines.

!dashboard_preview

 Payload Generator
The payload generator uses black magic involving Docker containers & Wine servers to compile executable payloads for any platform/architecture you select. These payloads spawn reverse TCP shells with communication over the network encrypted via AES-256 after generating a secure symmetric key using the Diffie-Hellman IKE.

!payloads_preview

 Terminal Emulator
The web app includes an in-browser terminal emulator so you can still have direct shell access even when using the web GUI.

!terminal_preview

 Console Application

 Client


Generate fully-undetectable clients with staged payloads, remote imports, and unlimited post-exploitation modules

1) __Remote Imports__: remotely import third-party packages from the server without writing them 
to the disk or downloading/installing them
2) __Nothing Written To The Disk__: clients never write anything to the disk - not even temporary files (zero IO
system calls are made) because remote imports allow arbitrary code to be 
dynamically loaded into memory and directly imported into the currently running 
process
3) __Zero Dependencies (Not Even Python Itself)__: client runs with just the python standard library, remotely imports any non-standard
packages/modules from the server, and can be compiled with a standalone python 
interpreter into a portable binary executable formatted for any platform/architecture,
allowing it to run on anything, even when Python itself is missing on the target host
4) __Add New Features With Just 1 Click__: any python script, module, or package you copy to the ./byob/modules/ directory
automatically becomes remotely importable & directly usable by every client while 
your command & control server is running
5) __Write Your Own Modules__: a basic module template is provided in ./byob/modules/ directory to make writing
your own modules a straight-f

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON