How vjeroen/purplecrew works
Project type and purpose
• PurpleCrew is a security-automation full-stack application that leverages AI agents (via CrewAI) to orchestrate Red Team, Blue Team, and IT Ops activities.
• The “crew-api.py” (FastAPI) serves as the HTTP entry point, while the “src/purplecrew” directory contains the core engine, individual crew implementations, and tool integrations.
File structure
• Top-level:
• crew-api.py (HTTP/REST API)
• index.html (optional simple UI)
• EmulationSummary.md, FullSummaryReport.md (output reports)
• pyproject.toml, uv.lock (build/config)
• src/purplecrew/main.py – boots the CrewAI flow and loads crews.
• src/purplecrew/crews/[redteamcrew|blueteamcrew|itopscrew] – each crew module implements a specialized agent workflow, backed by YAML configurations (agents.yaml, tasks.yaml).
• src/purplecrew/tools – collection of custom tool wrappers (Caldera, Azure Sentinel, MITRE, Terraform, etc.), plus HTML/JSON/Jinja2 templates.
README insights
• Emphasizes a modular architecture: agents, tools, task definitions are pluggable.
• Configuration files (YAML) feeding into each crew module.
• Data flow end-to-end: request → crew selection → task execution → external API → response/report.