n1nj4sec /pupy

Pupy is an opensource, cross-platform (Windows, Linux, OSX, Android) C2 and post-exploitation framework written in python and C

★ 9,007⑂ 1,847👁 2⑃ 228● 0▤ 0
PythonNOASSERTIONCreated 2015-09-21
+1
日增长
9,007
stars
1,847
forks
2
watchers
228
prs
0
issues
0
releases

README

Pupy



 Simple Installation


pip3 install pipx
pipx ensurepath
pipx install git+https://github.com/n1nj4sec/pupy@nextgen

pupysh

~~If you want more detailed information Refer to the wiki~~

 Development Install


git clone https://github.com/n1nj4sec/pupy
cd pupy
git checkout nextgen
git submodule init
git submodule update

pip install venv
python3 -m venv pupyvenv
source pupyvenv/bin/activate
pip install -r requirements.txt

run pupysh from the dev install :

source pupyenv/bin/activate
python3 -m pupy.cli


 Description

Pupy is a cross-platform, multi function C2 and post-exploitation tool mainly written in python. It features an all-in-memory execution guideline and leaves a very low footprint. Pupy can communicate using multiple transports, migrate into processes using reflective injection, and load remote python code, python packages and python C-extensions from memory.

 Features

- Windows payload can load the entire Python interpreter from memory using a reflective DLL.
	- Pupy does not touch the disk.

- Can be packed into a single .py file and run without any dependencies other than the python standard library on all OSes.
	- PyCrypto gets replaced by pure Python AES & RSA implementations when unavailable.

- Reflectively migrate into other processes.
- Remotely import pure python packages (.py, .pyc) and compiled python C extensions (.pyd, .so) from memory.
	- Imported python modules do not touch the disk.

- Easily extensible, modules are simple to write and are sorted by os and category.

- Modules can directly access python objects on the remote client using rpyc.

- Access remote objects interactively from the pupy shell and get auto-completion of remote attributes.

- Communication transports are modular and stackable. Exfiltrate data using HTTP over HTTP over AES over XOR, or any combination of the available transports.

- Communicate using obfsproxy pluggable transports.

- Execute noninteractive commands on multiple hosts at once.

- Commands and scripts running on remote hosts are interruptible.

- Auto-completion for commands and arguments.

- Custom config can be defined: command aliases, modules. automatically run at connection, etc.

- Open interactive python shells with auto-completion on the all-in-memory remote python interpreter.

- Interactive shells (cmd.exe, /bin/bash, etc) can be opened remotely.
	- Remote shells on Unix & Windows clients have a real tty with all keyboard signals working just like an SSH shell.

- Execute PE executable remotely and from memory.

- Generate payloads in various formats:

| Format | Architecture | Short Name |
|---|---|---|
~~ Android Package ~~ | x86 & ARMv7 | apk
Linux Binary | x86 | lin_x86
Linux Binary | x64 | lin_x64
Linux Shared Object | x86 | so_x86
Linux Shared Object | x64 | so_x64
Windows PE Executable | x86 | exe_x86
Windows PE Executable | x64 | exe_x64
Windows DLL | x86 | dll_x86
Windows DLL | x64 | dll_x64
Python Script | x86 & x64 | py
Python Oneliner | x86 & x64 | 

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