Files
NeuroSploit/legacy/README.md
T
CyberSecurityUP 55af0d4634 NeuroSploit v3.3.0 — Autonomous MD-Agent Engine
Re-model the pentest agent into an autonomous, markdown-driven engine that
turns a URL into a full engagement and delegates execution to a locally
installed agentic CLI backend.

Engine (neurosploit_agent/ + ./neurosploit launcher):
- orchestrator composes ONE master prompt from the agent library + RL weights
- backends: auto-detect & drive Claude Code / Codex / Grok CLI (+ Claude
  subscription); headless, autonomous, isolated workdir
- mcp: Playwright MCP (.mcp.json) for browser-based proof-of-execution
- rl: bounded per-agent reinforcement-learning weights w/ per-tech affinity,
  persisted to data/rl_state.json
- models: latest registry incl. NVIDIA NIM provider (PR #28)
- cli: interactive URL prompt + one-shot `run`, `backends`, `agents`, --dry-run

Agent library (agents_md/, 213 total):
- 196 vuln specialists incl. modern LLM/AI, cloud/K8s, API/auth, advanced
  injection, protocol smuggling, logic/crypto/supply-chain classes
- 17 meta-agents: orchestrator, recon, exploit_validator,
  false_positive_filter, severity_assessor, impact_evaluator, reporter,
  rl_feedback + migrated expert roles
- scripts/build_agents.py data-driven builder; REGISTRY.md index

Docs: rewritten README.md, v3.3.0 RELEASE.md, .env.example (NVIDIA NIM, xAI,
engine vars).

Retire legacy Python orchestration (neurosploit.py + agent classes) to legacy/.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 20:57:38 -03:00

26 lines
1.3 KiB
Markdown

# Legacy (pre-v3.3.0) Python orchestration
These files are the **previous** orchestration architecture, retired in
NeuroSploit v3.3.0 when the pentest agent was re-modeled into an autonomous,
markdown-driven engine that delegates execution to a local agentic CLI backend.
Kept for reference and migration only — **not** used by the v3.3.0 engine.
| Path | What it was |
|------|-------------|
| `neurosploit_legacy.py` | The 2,500-line monolithic CLI/orchestrator (`NeuroSploitv2`) |
| `agents_python/` | Hand-coded Python agent classes (web/exploitation/lateral/privesc/persistence/recon) |
| `custom_agents/` | Example custom Python agent |
## What replaced it
- **`neurosploit` + `neurosploit_agent/`** — the lean autonomous engine
(`orchestrator`, `agent_loader`, `backends`, `rl`, `mcp`, `models`, `cli`).
- **`agents_md/`** — 213 curated markdown agents (196 vuln specialists + 17
meta-agents) that the engine composes into a master prompt.
- The engine runs **Claude Code / Codex / Grok CLI** (or a Claude subscription)
as the autonomous runtime, with **Playwright MCP** for browser-based proof and
a **reinforcement-learning** loop that adapts agent selection across runs.
Run `./neurosploit` (interactive) or `./neurosploit run <url>` to use the new engine.