Skip to content

vedantb7/kyt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ”Ž KYT – Know Your Target

KYT (Know Your Target) is a high-performance, persona-driven password generation engine written in Rust.

It is designed for:

  • βœ… Authorized red-team simulations
  • βœ… Enterprise IAM password policy auditing
  • βœ… CTF challenge development
  • βœ… Security research & compliance testing

KYT intelligently models how humans create passwords based on personal, professional, and contextual data.


πŸš€ Features

🧠 Persona-Based Mutation Engine

  • Cross-category combinator (depth ≀ 3 / ≀ 4 in aggressive mode)
  • Identity, Geography, Professional & Personal data modeling
  • Intelligent date fragment derivation (DD, MM, YY, YYYY, DDMM)
  • Reverse variants
  • Case permutations
  • L33t substitutions
  • Symbol prefix / suffix / infix injection
  • Numeric mask expansion (000–999 / 0000–9999 in aggressive mode)
  • Policy-aware pruning
  • Deduplicated output

πŸ”₯ Aggressive CTF Mode

Enable deeper combinator logic and expanded mutation space:

--aggressive

Adds:

  • Depth 4 cross stacking
  • Larger numeric mask space
  • Extended symbol injection
  • Multi-level l33t mutations

βš™ Streaming Bruteforce Engine

Optional full keyspace generation:

--bruteforce
  • Cartesian charset enumeration
  • Streaming output (no memory explosion)
  • Resume checkpoint support
  • Parallelized with Rayon

πŸ“Š Enterprise Password Policy Support

  • Minimum / Maximum length
  • Required uppercase
  • Required lowercase
  • Required numeric
  • Required symbol
  • Mandatory inclusion strings
  • Exclusion strings
  • Pre-validation before write

πŸ— Architecture

KYT
 β”œβ”€β”€ interview.rs       # Interactive persona builder
 β”œβ”€β”€ models.rs          # Data structures
 β”œβ”€β”€ mutation.rs        # Persona mutation engine
 β”œβ”€β”€ bruteforce.rs      # Streaming brute engine
 β”œβ”€β”€ policy.rs          # Password policy validation
 β”œβ”€β”€ writer.rs          # Buffered output writer
 └── main.rs            # CLI entrypoint

Parallelization powered by:

  • rayon
  • indicatif (CLI progress)
  • clap (CLI parsing)

πŸ“¦ Installation

Prerequisites

Install Rust:

Windows

Download from: https://rustup.rs

Or PowerShell:

winget install Rustlang.Rustup

Linux

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

macOS

brew install rust

or via rustup:

curl https://sh.rustup.rs -sSf | sh

πŸ”¨ Build KYT

Clone the repository:

git clone https://github.com/Vedant-VB07/kyt.git
cd KYT-Know-Your-Target

Build release binary:

cargo build --release

Binary will be located at:

target/release/KYT-Know_Your_Target

πŸ–₯ Deployment

Windows

After building:

target\release\KYT-Know_Your_Target.exe

You can move the .exe into:

C:\Windows\System32

or any directory added to PATH.


Linux

Move binary to:

sudo mv target/release/KYT-Know_Your_Target /usr/local/bin/kyt

Now run:

kyt

macOS

Same as Linux:

sudo mv target/release/KYT-Know_Your_Target /usr/local/bin/kyt

πŸ§ͺ Usage

Interactive Mode

cargo run --release

Aggressive CTF Mode

cargo run --release -- --aggressive

JSON Persona Mode (CI/CD Friendly)

cargo run --release -- --json persona.json

Streaming Bruteforce Mode

cargo run --release -- --bruteforce

Resume from checkpoint:

cargo run --release -- --bruteforce --resume 5000000

🧠 Example Output

For:

  • Name: john
  • Nicknames: doe, jelly
  • Birthdate: 01011999
  • Policy: 6–8 chars, upper+lower+digit+symbol

KYT may generate:

doe0101!
jelly!
john1999

πŸ“ˆ Performance

  • Parallel mutation via Rayon
  • HashSet-based deduplication
  • Streaming mode for large-scale brute enumeration
  • Efficient early length pruning
  • Optimized release builds recommended

πŸ” Security Notice

KYT is designed strictly for:

  • Authorized penetration testing
  • Security auditing
  • Educational use
  • CTF development

Do not use this tool against systems without explicit written authorization.

The author assumes no liability for misuse.


πŸ›  Roadmap

  • Entropy scoring module
  • Probability ranking engine
  • Streaming mutation mode (no HashSet)
  • Performance metrics dashboard
  • Distributed generation support
  • Wordlist export formats (hashcat/JTR masks)

πŸ“œ License

MIT License


πŸ‘¨β€πŸ’» Author

Vedant Bondekar


⭐ If You Like This Project

Star the repository and contribute!


About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages