⚔️ 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
SubfinderandFindomainfor maximum coverage. - Intelligent Deduplication: Merges and purges duplicate entries to ensure resource efficiency.
- Tech-Stack Fingerprinting: Leverages
HTTPXto 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.
- Install System Dependencies
sudo apt update && sudo apt install -y python3-venv python3-pip nmap tor wget
- 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/
- 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 | |
| Valhalla Security Labs | Senior Software Engineering meets Offensive Security. | Website |
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3123a664ce0c3a8ddcc1dcbf80266a04061ddf5d166788d8fd8ebb724842a2d2
|
|
| MD5 |
0097bc462719a1828bd988f38619116e
|
|
| BLAKE2b-256 |
112fe47405718fdd1e2720564da4891a516389c591d3337af964d7df6c241c76
|
Provenance
The following attestation bundles were made for vsl_valkyrie-1.0.0.tar.gz:
Publisher:
python-publish.yml on TheWyv3rn/Valkyrie
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vsl_valkyrie-1.0.0.tar.gz -
Subject digest:
3123a664ce0c3a8ddcc1dcbf80266a04061ddf5d166788d8fd8ebb724842a2d2 - Sigstore transparency entry: 1437711457
- Sigstore integration time:
-
Permalink:
TheWyv3rn/Valkyrie@58faf841d645646133aaab5adcf8d1668ce49e9e -
Branch / Tag:
refs/tags/v1.4 - Owner: https://github.com/TheWyv3rn
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-publish.yml@58faf841d645646133aaab5adcf8d1668ce49e9e -
Trigger Event:
push
-
Statement type:
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
23fa66a6bb57ce7045b79b8cdb150e1ba6e3e57946122352ec9a45ab7e4b076b
|
|
| MD5 |
a5d82857a7acfdf59c58212b40d25938
|
|
| BLAKE2b-256 |
51a250fc565c3d0d1956173a94be9ec812aef15c5304b07912858d5e89196144
|
Provenance
The following attestation bundles were made for vsl_valkyrie-1.0.0-py3-none-any.whl:
Publisher:
python-publish.yml on TheWyv3rn/Valkyrie
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vsl_valkyrie-1.0.0-py3-none-any.whl -
Subject digest:
23fa66a6bb57ce7045b79b8cdb150e1ba6e3e57946122352ec9a45ab7e4b076b - Sigstore transparency entry: 1437711466
- Sigstore integration time:
-
Permalink:
TheWyv3rn/Valkyrie@58faf841d645646133aaab5adcf8d1668ce49e9e -
Branch / Tag:
refs/tags/v1.4 - Owner: https://github.com/TheWyv3rn
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-publish.yml@58faf841d645646133aaab5adcf8d1668ce49e9e -
Trigger Event:
push
-
Statement type: