Skip to main content

⚔️ Valkyrie: An advanced, modular reconnaissance engine for security professionals.

Project description

⚔️ VALKYRIE v1.0 | Reconnaissance Engine

Part of the Valhalla Security Labs Suite

"Choosing the slain on the digital battlefield."

Valkyrie is a high-speed, modular reconnaissance framework designed for bug bounty hunters and security auditors. It automates the transition from raw target discovery to actionable, confirmed infrastructure lists.


⚡ Core Capabilities

  • Multi-Source Harvesting: Orchestrates Subfinder and Findomain for maximum coverage.
  • Intelligent Deduplication: Merges and purges duplicate entries to ensure resource efficiency.
  • Tech-Stack Fingerprinting: Leverages HTTPX to identify WAFs, CMS (WP/JS), and backend technologies.
  • Target Refinement: Automates the cleanup of protocols and resolves live domains to confirmed IP assets.
  • Anonymity Ready: Native support for proxy routing and hardened DNS configurations.

🛠 Project Architecture

Valkyrie/
├── Valkyrie.py           # Master Orchestrator
├── modules/
│   └── recon/
│       └── recon.py      # The Heavy Lifter (Sub-discovery & Resolution)
└── logs/                 # Encrypted/Session Logs (Planned)  
proxies.txt               # Proxy Lists

🛠 Prerequisites & Installation

Valkyrie requires a Linux environment (optimized for Debian) and the Go Programming Language.

  1. Install System Dependencies
sudo apt update && sudo apt install -y python3-venv python3-pip nmap tor wget
  1. Install Go-Based Artillery
    Ensure your Go bin directory is in your $PATH (usually ~/go/bin).
# Core Discovery
go install -v [github.com/projectdiscovery/subfinder/v2/cmd/subfinder@latest](https://github.com/projectdiscovery/subfinder/v2/cmd/subfinder@latest)
go install -v [github.com/projectdiscovery/httpx/cmd/httpx@latest](https://github.com/projectdiscovery/httpx/cmd/httpx@latest)

# Port Scanning & Crawling
go install -v [github.com/projectdiscovery/naabu/v2/cmd/naabu@latest](https://github.com/projectdiscovery/naabu/v2/cmd/naabu@latest)
go install -v [github.com/projectdiscovery/katana/cmd/katana@latest](https://github.com/projectdiscovery/katana/cmd/katana@latest)

# Findomain (Rust)
wget [https://github.com/Findomain/Findomain/releases/latest/download/findomain-linux.zip](https://github.com/Findomain/Findomain/releases/latest/download/findomain-linux.zip)
unzip findomain-linux.zip && chmod +x findomain && mv findomain ~/go/bin/
  1. Setup Valkyrie
git clone [https://github.com/TheWyv3rn/Valkyrie.git](https://github.com/TheWyv3rn/Valkyrie.git)  
cd valkyrie  
python3 -m venv venv  
source venv/bin/activate  
pip install -r requirements.txt  

OR

pip install VSL_Valkyrie  

🚀 Tactical Usage

Valkyrie uses a flag-based system to control the "Ghost Protocol" (anonymity layers) and execution depth.

BASIC RECON Fast Discoveries

python3 Valkyrie.py -d target.com --recon-only

Fully Cloaked Engagement (VPN + Tor + Proxy Rotation)

python3 Valkyrie.py -d target.com -a -vl JP

Flag Reference

FLAG DESCRIPTION
-d Domain: The target asset (REQUIRED)
-a ALL Anon: Enables TOR, VPN, & PROXIES
-v VPN: Ensures ProtonVPN is active before scanning.
-vl VPN Location: _Specificy County (e.g., -vl CA for Canada)
-t TOR: _Routes tool traffic through the Tor Services.
-p Proxy: _Enalbes Verified rotation from proxies.txt.
--recon-only HOT RUN: Skips all anonymous checks for local/internet testing.

📊 Output Manifest

Valkyrie generates a structured intelligence folder for each target:

  • target_subs.txt: Every discovered unique subdomain.
  • target_confirmed_ips.txt: Resolved IPv4 addresses for the infrastructure.
  • target_live_urls.txt: Verified HTTP/HTTPS endpoints for crawling.
  • target_nmap_vuln.txt: Results from the Nmap Scripting Engine.
  • target_katana_crawl.txt: Deep-crawled parameters and JS files.

Made By:

The Valkyrie tool is designed, developed, and deployed by;

NAME: DESCRIPTION: LINK:
Brogan Cole Gallagher (AKA TheWyv3rn) The Developer of Valkyrie Email
Valhalla Security Labs Senior Software Engineering meets Offensive Security. Website

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vsl_valkyrie-1.0.0.tar.gz (7.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vsl_valkyrie-1.0.0-py3-none-any.whl (8.5 kB view details)

Uploaded Python 3

File details

Details for the file vsl_valkyrie-1.0.0.tar.gz.

File metadata

  • Download URL: vsl_valkyrie-1.0.0.tar.gz
  • Upload date:
  • Size: 7.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for vsl_valkyrie-1.0.0.tar.gz
Algorithm Hash digest
SHA256 3123a664ce0c3a8ddcc1dcbf80266a04061ddf5d166788d8fd8ebb724842a2d2
MD5 0097bc462719a1828bd988f38619116e
BLAKE2b-256 112fe47405718fdd1e2720564da4891a516389c591d3337af964d7df6c241c76

See more details on using hashes here.

Provenance

The following attestation bundles were made for vsl_valkyrie-1.0.0.tar.gz:

Publisher: python-publish.yml on TheWyv3rn/Valkyrie

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vsl_valkyrie-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: vsl_valkyrie-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 8.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for vsl_valkyrie-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 23fa66a6bb57ce7045b79b8cdb150e1ba6e3e57946122352ec9a45ab7e4b076b
MD5 a5d82857a7acfdf59c58212b40d25938
BLAKE2b-256 51a250fc565c3d0d1956173a94be9ec812aef15c5304b07912858d5e89196144

See more details on using hashes here.

Provenance

The following attestation bundles were made for vsl_valkyrie-1.0.0-py3-none-any.whl:

Publisher: python-publish.yml on TheWyv3rn/Valkyrie

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page