How sweetsoftware/ares works
Ares pairs an operator-facing command-and-control web server with an endpoint agent. The central workflow is an agent checking in for queued instructions, executing them, and reporting output or uploaded files; operators manage agents and queue commands through the web UI/API. The README also documents agent-side file, shell, Python, screenshot, persistence, cleanup, and termination commands, plus an agent builder. The graph uses README relationships where source excerpts are incomplete; the main agent loop and some documented capabilities were not fully sampled.
Main entry points: agent.py Agent Runtime · api/__init__.py Agent API · webui/__init__.py Admin Web UI · models.py Domain Models
Components 17
C2 Server
- Flask App
server/ares.py - Admin Web UI
server/webui/__init__.py - Agent API
server/api/__init__.py - Domain Models
server/models.py - SQLite Database
server/config.py - Uploaded Files
server/api/__init__.py
Endpoint Agent
- Agent Runtime
agent/agent.py - Agent Settings
agent/config.py - Shell Commands
agent/agent.py - File Transfer
agent/agent.py - Python Execution
agent/agent.py - Archive and Screenshot
agent/agent.py - Persistence and Cleanup
agent/agent.py
Agent Build
- Agent Builder
agent/builder.py - Build Settings
agent/template_config.py
Other components
- Operator
- Compromised Host
Connections 23
- Operator → Admin Web UI: administers
README.md - Admin Web UI → Domain Models: queries and updates
server/webui/__init__.py - Agent API → Domain Models: queues and records
server/api/__init__.py - Flask App → Admin Web UI: registers
server/ares.py - Flask App → Agent API: registers
server/ares.py - Flask App → Domain Models: initializes
server/ares.py - Domain Models → SQLite Database: persists records
server/config.py - Admin Web UI → Agent API: requests commands
server/api/__init__.py - Agent Runtime → Agent Settings: reads settings
agent/agent.py - Compromised Host → Agent Runtime: runs
README.md - Agent Runtime → Agent API: checks in
agent/agent.py - Agent Runtime → Agent API: reports output
agent/agent.py - Agent API → Agent Runtime: returns commands
server/api/__init__.py - Agent Runtime → Shell Commands: dispatches to
agent/agent.py - Agent Runtime → File Transfer: dispatches to
agent/agent.py - Agent Runtime → Python Execution: dispatches to
agent/agent.py - Agent Runtime → Archive and Screenshot: dispatches to
agent/agent.py - Agent Runtime → Persistence and Cleanup: dispatches to
README.md - File Transfer → Agent API: uploads files
agent/agent.py - Agent API → Uploaded Files: stores uploads
server/api/__init__.py - Operator → Agent Builder: configures build
README.md - Agent Builder → Build Settings: fills settings
agent/builder.py - Agent Builder → Agent Runtime: packages agent
agent/builder.py