Skip to content

feat: add Rust-native Ares agent templates and golden image support#201

Merged
l50 merged 5 commits intomainfrom
fix/warpgate-templates
Apr 16, 2026
Merged

feat: add Rust-native Ares agent templates and golden image support#201
l50 merged 5 commits intomainfrom
fix/warpgate-templates

Conversation

@l50
Copy link
Copy Markdown
Contributor

@l50 l50 commented Apr 16, 2026

Key Changes:

  • Introduced Rust-based Ares agent templates for all major red/blue team roles
  • Added golden AMI template for unified red team tool deployment
  • Replaced legacy Python-based templates with modular Rust+Python agent images
  • Enhanced documentation and pre-commit infrastructure for new template structure

Added:

  • Rust-native agent templates - Added ares-rust-* templates for:
    • acl-agent, coercion-agent, cracker-agent, credential-access-agent, lateral-movement-agent, privesc-agent, recon-agent, worker, orchestrator, blue-agent, blue-triage-agent, blue-threat-hunter-agent, blue-lateral-analyst-agent, and cli
  • GPU-enabled Rust cracker agent - Added ares-rust-cracker-agent-gpu for CUDA/OpenCL hashcat with Rust worker
  • Golden AMI template - New ares-golden-image for comprehensive pre-baked red team AMI deployments
  • Template documentation - Added detailed READMEs for all new Rust-based agent templates
  • Pre-commit and linter configs - .pre-commit-config.yaml, .hooks/, and linter settings for consistent formatting and validation

Changed:

  • Template structure - All legacy Python agent templates removed and replaced with Rust-based equivalents under templates/
  • Template build system - Updated references and documentation to point to new Rust-native agent templates
  • Documentation - Overhauled main README.md to describe new agent taxonomy, usage, and modular template approach
  • CI workflows - Updated workflows and labeler rules to reflect the new template layout and file organization
  • Label and metadata conventions - Improved label definitions, labeler, and metadata checks for new template types

Removed:

  • Legacy agent templates - Removed all Python-based agent templates:
    • ares-base, ares-worker, ares-orchestrator, and all individual role agent templates under the old naming
  • Legacy blue team templates - Removed ares-blue-agent, ares-blue-triage-agent, ares-blue-threat-hunter-agent, ares-blue-lateral-analyst-agent
  • Redundant documentation - Deleted all outdated role-specific template READMEs for the old structure

… template set

**Added:**

- Introduced Rust-native agent templates for Ares, including:
  - ares-rust-acl-agent: AD ACL exploitation agent with Rust binary and Ansible tooling
  - ares-rust-blue-agent: Blue team defensive agent (Rust, embedded Python)
  - ares-rust-blue-triage-agent: Blue triage agent (Rust, Grafana MCP)
  - ares-rust-blue-threat-hunter-agent: Blue threat hunter (Rust, Grafana MCP)
  - ares-rust-blue-lateral-analyst-agent: Blue lateral analyst (Rust, Grafana MCP)
  - ares-rust-coercion-agent: NTLM relay/coercion agent (Rust, Ansible)
  - ares-rust-cracker-agent: Password cracker agent (Rust, hashcat/john, Ansible)
  - ares-rust-cracker-agent-gpu: GPU-accelerated password cracker (Rust, CUDA/OpenCL)
  - ares-rust-credential-access-agent: Credential access agent (Rust, Kerberos, Ansible)
  - ares-rust-lateral-movement-agent: Lateral movement agent (Rust, Ansible)
  - ares-rust-orchestrator: Orchestrator binary with embedded Python for LLM ops
  - ares-rust-privesc-agent: Privilege escalation agent (Rust, Ansible)
  - ares-rust-recon-agent: Reconnaissance agent (Rust, AD/network tools, Ansible)
  - ares-rust-worker: Generic worker agent (Rust binary, embedded Python)
  - ares-rust-cli: Pure Rust CLI for Ares framework (no Python)
- Added ares-golden-image AMI template for full red team toolset golden image
- Added comprehensive README and documentation for each new template
- Provided .gitignore, pre-commit config, and linter configs for template repo
- Added shell hooks and formatting utilities for pre-commit and workflow checks

**Changed:**

- Modernized template directory structure: moved all existing agent templates to `templates/` and replaced Python-based agent templates with Rust-based equivalents
- Updated main repository README with new template list, features, usage, and architectural overview reflecting Rust migration and new capabilities
- Improved documentation for blue team, GPU, and CLI templates, clarifying runtime, build, and orchestration differences
- Updated CI workflows and validation logic to support new Rust-based templates and ensure build/test consistency
- Updated workflow and pre-commit scripts to check for consistency in workflow repository lists and enforce formatting/linters
- Enhanced template build chains to support multi-arch, Rust compilation, and embedded Python agent operation
- Added AMI/golden image build for red team labs covering recon, credential access, privesc, cracking, lateral movement, ACL abuse, and coercion

**Removed:**

- Removed all legacy Python-based agent templates:
  - ares-acl-agent, ares-blue-agent, ares-blue-triage-agent, ares-blue-threat-hunter-agent, ares-blue-lateral-analyst-agent, ares-coercion-agent, ares-cracker-agent, ares-cracker-agent-gpu, ares-cracker-base-gpu, ares-credential-access-agent, ares-lateral-movement-agent, ares-privesc-agent, ares-recon-agent, ares-worker, ares-base, ares-orchestrator and their corresponding READMEs and warpgate.yaml files
- Removed Python-centric documentation and notes from main and template-specific READMEs
- Removed template duplication and legacy shell/Ansible-only build steps in favor of Rust-native agent binaries with embedded Python support
@dreadnode-renovate-bot dreadnode-renovate-bot Bot added the area/github Changes made to GitHub Actions workflows label Apr 16, 2026
l50 added 4 commits April 16, 2026 14:46
**Changed:**

- Updated all GitHub Actions workflows and labeler configuration to reference
  'warpgate-templates' instead of 'templates' for template-related operations,
  including build, validation, and test processes
- Adjusted shell and Python scripts within workflows to search, loop, and
  operate on 'warpgate-templates' paths, ensuring correct discovery and
  validation of template files
- Modified labeler rules to apply the area/templates label to changes under
  'warpgate-templates', maintaining accurate PR labeling
ci: remove GITHUB_TOKEN build-arg from warpgate build steps

**Changed:**

- Updated build-and-push-templates workflow to no longer pass GITHUB_TOKEN as a
  build-arg to warpgate build commands, removing both the flag and related
  comments. This simplifies the build invocation and eliminates unnecessary
  exposure of the token.
- Updated test-template-builds workflow to remove the --build-arg
  "GITHUB_TOKEN=${GITHUB_TOKEN}" parameter from warpgate build steps, aligning
  test builds with the new approach and reducing secrets usage.

**Removed:**

- Eliminated passing of GITHUB_TOKEN as a build argument to container builds in
  all relevant GitHub Actions workflows.
```
**Added:**

- Specify `kalilinux/kali-rolling:latest` as the base image in the
  ares-golden-image template to standardize environment for builds
…nsistent indentation

**Changed:**

- Updated workflow to check required files in `warpgate-templates/templates/*/`
  instead of `warpgate-templates/*/` for correct directory structure in
  `validate-templates.yaml`
- Reformatted `warpgate.yaml` for the ares-golden-image template to use
  consistent two-space indentation across all sections, improving readability
  and aligning with common YAML conventions
@l50 l50 merged commit 472e3cf into main Apr 16, 2026
13 checks passed
@l50 l50 deleted the fix/warpgate-templates branch April 16, 2026 21:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/github Changes made to GitHub Actions workflows

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant