GH05TCREW/pentestagent

🕵️ PentestAgent: AI agent tự động hóa black-box pentest, có "crew" biết tự sinh con để phối hợp

AI agent framework cho black-box security testing — từ bug bounty, red-team đến penetration testing, hỗ trợ multi-agent, playbook và Docker isolation.

PentestAgent là framework mã nguồn mở viết bằng Python, dùng AI agent để tự động hóa quy trình kiểm thử bảo mật hộp đen. Dự án phù hợp cho dân bug bounty, red-team và pentester muốn biến các bước kiểm thử thủ công thành các phiên làm việc có agent tự chạy — từ quét cổng, khai thác lỗ hổng đến sinh báo cáo.

✨ Điểm nổi bật

• 4 chế độ hoạt động: /assist cho lệnh một lần, /agent chạy tự động một tác vụ, /crew bật multi-agent với orchestrator điều phối worker chuyên biệt, /interact để trò chuyện và được agent hướng dẫn trong suốt quá trình pentest.
• Agent tự sinh agent con: tool spawn_mcp_agent cho phép agent đang chạy tự tạo một child agent dạng MCP server qua stdio — tách biệt hoàn toàn runtime, LLM client, lịch sử hội thoại và notes, sau đó inject toàn bộ tool set của child vào parent. Tự tổ chức phân cấp mà không cần orchestration bên ngoài.
• MCP-compatible: hỗ trợ Model Context Protocol để mở rộng tool, có lệnh /mcp để thêm server, /spawn để sinh child agent kèm scope CIDR, model riêng.
• Playbooks dựng sẵn: ví dụ pentestagent run -t example.com --playbook thp3_web — chạy theo kịch bản tấn công có cấu trúc cho black-box testing.
• Tool tích hợp: terminal, browser, notes, web_search (cần TAVILY_API_KEY) và spawn_mcp_agent.
• Docker isolation: image dựng sẵn gồm base image (nmap, netcat, curl) và Kali image (metasploit, sqlmap, hydra...), agent gọi trực tiếp qua terminal tool.
• TUI đầy đủ: quản lý target, tools, notes, report, memory, system prompt, lưu/khôi phục hội thoại.
• Đa provider LLM: dùng được OpenAI, Anthropic hoặc bất kỳ model nào LiteLLM hỗ trợ, kể cả relay endpoint qua OPENAI_API_BASE / ANTHROPIC_API_BASE.

💡 Vì sao đáng chú ý

Điểm thú vị nhất không nằm ở việc "AI chạy lệnh nmap", mà ở thiết kế tự tổ chức: một agent có thể tự sinh ra agent con để giao việc theo scope, mỗi đứa có runtime và bộ nhớ riêng. Đây là hướng tiếp cận hierarchical multi-agent khá gọn — không cần framework orchestration nặng nề bên ngoài.

Cách dùng cũng linh hoạt: muốn nhanh thì /assist một phát, muốn sâu thì /crew hoặc playbook có cấu trúc. Kết hợp Docker với image Kali giúp cô lập môi trường và có sẵn bộ công cụ pentest. Hợp với ai đang làm bug bounty, red-team hoặc muốn thử nghiệm tự động hóa quy trình pentest.

#AI #Pentest #RedTeam #BugBounty #TiniX