Skip to content

chriz-3656/ReconAssistant

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

>> NEURO-RECON: AI SHADOW SUITE <<

Developed by chriz3656 | Powered by Scrapling and Groq AI

NEURO-RECON Interface

NEURO-RECON is an advanced, AI-driven reconnaissance orchestrator designed for elite bug bounty hunters and security researchers. It combines high-performance asynchronous crawling with Llama-3-powered intelligence to map attack surfaces and prioritize vulnerabilities in seconds.

🚀 Key Features

🧠 Neural Interface

  • Neural Chat: Interrogate your harvested data in real-time. Ask the Shadow AI about specific endpoints, suspicious JS files, or potential attack vectors.
  • Autonomous Strategy: Automatically generates a professional Red Team strategy tailored to the specific target's architecture.

🕸️ Deep Infiltration

  • Recursive Neural Crawl: High-speed asynchronous discovery of links and assets.
  • Deep Form Extraction: Captures all HTML forms, input fields, methods, and actions to detect XSS/CSRF vectors.
  • JS Endpoint Analysis: Deep-parses JavaScript files to reveal hidden API routes and relative paths.
  • API Hinting: Detects internal API patterns (/api/v1/, /graphql, etc.) hidden in code.

💎 Shadow Reporting

  • Vulnerability Prioritization: Finds are ranked (High, Medium, Low) using Groq's LLMs.
  • Neural Harvest Summary: Instant terminal dashboard of all discovered assets.
  • JSON Archive: Structured reports for easy integration with other tools.

🛠️ Installation

  1. Clone the Suite:
git clone https://github.com/chriz-3656/ReconAssistant.git
cd ReconAssistant
  1. Setup Environment:
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
  1. Configure Neural Link (Optional): Add your Groq API key to a .env file for AI features:
GROQ_API_KEY=gsk_your_key_here

🎮 Usage

Launch the Neural Interface:

./launch.sh

Or use the CLI directly:

python cli.py https://example.com --depth 2 --concurrent 5

📂 Project Architecture

  • recon.py: The main Neural Interface (Orchestrator).
  • main.py: The core logic controller and AI strategy engine.
  • core/: Scrapling-powered async spider and link crawler.
  • extractors/: Specialized engines for forms, JS, and regex patterns.
  • analysis/: Groq AI integration for chat and prioritization.
  • output/: Rich terminal formatting and report generation.

🏷️ GitHub Topics

bug-bounty, reconnaissance, ai-security, web-scraping, vulnerability-detection, python, penetration-testing, red-team, groq-api, scrapling


⚠️ Disclaimer

This tool is for educational and authorized security testing purposes only. The developer (chriz3656) is not responsible for any misuse or illegal activities performed with this suite.

About

NEURO-RECON: Advanced AI-driven reconnaissance orchestrator for bug bounty hunting and security research. Features neural chat, autonomous strategy, and deep form extraction.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors