NullSec Framework

February 27, 2026 · View on GitHub

    ███▄    █  █    ██  ██▓     ██▓      ██████ ▓█████  ▄████▄  
    ██ ▀█   █  ██  ▓██▒▓██▒    ▓██▒    ▒██    ▒ ▓█   ▀ ▒██▀ ▀█  
   ▓██  ▀█ ██▒▓██  ▒██░▒██░    ▒██░    ░ ▓██▄   ▒███   ▒▓█    ▄ 
   ▓██▒  ▐▌██▒▓▓█  ░██░▒██░    ▒██░      ▒   ██▒▒▓█  ▄ ▒▓▓▄ ▄██▒
   ▒██░   ▓██░▒▒█████▓ ░██████▒░██████▒▒██████▒▒░▒████▒▒ ▓███▀ ░
   ░ ▒░   ▒ ▒ ░▒▓▒ ▒ ▒ ░ ▒░▓  ░░ ▒░▓  ░▒ ▒▓▒ ▒ ░░░ ▒░ ░░ ░▒ ▒  ░
   ░ ░░   ░ ▒░░░▒░ ░ ░ ░ ░ ▒  ░░ ░ ▒  ░░ ░▒  ░ ░ ░ ░  ░  ░  ▒   
      ░   ░ ░  ░░░ ░ ░   ░ ░     ░ ░   ░  ░  ░     ░   ░        
      ░   ░    ░   ░       ░       ░         ░     ░   ░ ░      
            ░                          ░    ░           ░        
   ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
   █░░░░░░░░░░░░░░░ F R A M E W O R K  ░░░░░░░░░░░░░░░░░░░░░░░█
   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
                       bad-antics

Python Go Rust

The unified command center for all NullSec security tools

Overview

NullSec Framework is a modular penetration testing and security research framework that integrates all NullSec tools into a cohesive environment. It provides a unified interface for reconnaissance, exploitation, forensics, and post-exploitation activities.

Features

  • 🎯 Unified Interface - Single CLI for all NullSec modules
  • 📦 Module System - Easy integration of new tools
  • 🔧 Auto-Configuration - Detects and configures available tools
  • 📊 Session Management - Track targets, findings, and artifacts
  • 🔄 Workflow Automation - Chain modules for complex operations
  • 📝 Reporting - Generate detailed assessment reports

Integrated Toolkits

Reconnaissance

ToolLanguageDescription
nullsec-reconGo, Rust, PythonActive/passive reconnaissance toolkit
nullsec-portscanElixirLightning-fast async port scanner
nullsec-snifferClojureNetwork packet analyzer

Exploitation

ToolLanguageDescription
nullsec-exploitPython, C, RustExploit development toolkit
nullsec-injectorOdinProcess memory injector
nullsec-webTypeScript, PythonWeb application security

Cryptography

ToolLanguageDescription
nullsec-cryptoRust, Python, C, CrystalCryptographic analysis toolkit
nullsec-hashwitchJuliaHigh-performance hash cracker

Forensics & Analysis

ToolLanguageDescription
nullsec-forensicsGo, Python, RustDigital forensics toolkit
nullsec-logwipeScalaLog analysis and manipulation

Stealth & Evasion

ToolLanguageDescription
nullsec-stealthCrystal, Lua, D, Haskell, VAnti-detection toolkit
nullsec-cloakerErlangProcess and file cloaking

Command & Control

ToolLanguageDescription
nullsec-beaconOCamlLightweight beacon system
nullsec-keysniffF#Keyboard event monitor

Wireless

ToolLanguageDescription
nullsec-wifiKotlin, JavaWiFi security toolkit
nullsec-bluetoothKotlin, JavaBluetooth security toolkit

Mobile

ToolLanguageDescription
nullsec-androidKotlin, JavaAndroid security toolkit
nullsec-iosSwift, Objective-CiOS security toolkit

Monitoring & Console

ToolLanguageDescription
glowbarnRustSecurity console & resource monitoring

Installation

# Clone framework
git clone https://github.com/bad-antics/nullsec-framework.git
cd nullsec-framework

# Install dependencies
pip install -r requirements.txt

# Initialize framework
./nullsec init

# Auto-detect and configure modules
./nullsec setup --auto

Quick Start

# Start interactive shell
./nullsec console

# List available modules
nullsec> modules list

# Load a module
nullsec> use recon/portscan

# Set options
nullsec> set target 192.168.1.0/24
nullsec> set ports 1-1000

# Run module
nullsec> run

# Generate report
nullsec> report html output.html

Module Management

# Install a module
./nullsec module install nullsec-beacon

# Update all modules
./nullsec module update --all

# Create new module
./nullsec module create my-tool --language python

# List installed modules
./nullsec module list --installed

Configuration

# ~/.nullsec/config.yaml
framework:
  workspace: ~/nullsec-workspace
  auto_save: true
  verbose: false

modules:
  path: ~/.nullsec/modules
  auto_load: true

database:
  type: sqlite
  path: ~/.nullsec/data.db

reporting:
  default_format: html
  include_screenshots: true

Language Support

The framework supports modules written in 30+ programming languages:

CategoryLanguages
SystemsRust, Go, C, C++, Zig, Odin, D, V
ScriptingPython, Ruby, Lua, Perl
JVMKotlin, Java, Scala, Clojure
FunctionalHaskell, OCaml, F#, Erlang, Elixir
WebTypeScript, JavaScript
AppleSwift, Objective-C
OtherNim, Crystal, Julia

Directory Structure

nullsec-framework/
├── nullsec              # Main entry point
├── core/                # Framework core
│   ├── console.py       # Interactive console
│   ├── module.py        # Module management
│   ├── session.py       # Session handling
│   └── config.py        # Configuration
├── modules/             # Module directory
│   ├── recon/
│   ├── exploit/
│   ├── forensics/
│   └── ...
├── lib/                 # Shared libraries
├── data/                # Data files
└── docs/                # Documentation

Creating Modules

# modules/my_module/my_module.py
from nullsec.core.module import Module

class MyModule(Module):
    name = "my_module"
    description = "My custom module"
    author = "bad-antics"
    
    options = {
        "target": {"required": True, "description": "Target address"},
        "port": {"required": False, "default": 80, "description": "Port number"}
    }
    
    def run(self):
        target = self.options["target"]
        self.log_info(f"Running against {target}")
        # Module logic here
        return self.results

Community

Disclaimer

This framework is intended for authorized security testing and educational purposes only. Users are responsible for obtaining proper authorization before testing any systems. Unauthorized access to computer systems is illegal.

License

NullSec Proprietary License

Author

bad-antics - NullSec Security Team


The unified penetration testing platform