How cleytonsilva/artex works
ARTEX is a self-hosted, LLM-driven penetration-testing platform. Users define a task goal; the planner decomposes it into intents, workers execute tools, and results update the per-task exploration graph and shared asset graph. Findings can retain request/response evidence and be retested, while scope, approval, and budget controls constrain autonomous actions. The graph also includes traffic capture and the management UI. Relationships among unsampled subsystems are included only where the README documents them; source excerpts provide additional evidence for selected engine, API, and ingestion links.
Main entry points: worker.go Intent workers · engine.go Event-driven engine · server.go HTTP API · planner.go Goal planner
Components 24
Task orchestration
- Task manager
server/manager.go - Event-driven engine
server/engine.go - Goal planner
agent/planner.go - Intent workers
agent/worker.go
Testing and safeguards
- Security tools
agent/tools.go - Scan ingestion
agent/scan_ingest.go - Action guard
guard/guard.go - Approval gates
intercept/intercept.go - Scoped egress
egress/egress.go
Graphs and evidence
- Traffic recorder
traffic/traffic.go - Shared asset graph
db/assets.go - Exploration graph
db/exploration.go - Traffic evidence
evidence/store.go - Finding reports
report/findings.go
User interfaces
- Web console
web/src/app/(main)/function/tasks/page.tsx - HTTP API
server/server.go - Findings explorer
web/src/app/(main)/function/findings/page.tsx - Asset tree
web/src/app/(main)/function/findings/_components/asset-tree.tsx - Findings table
web/src/app/(main)/function/findings/_components/findings-table.tsx - Traffic console
web/src/app/(main)/function/traffic/page.tsx
Platform services
- LLM recorder
llmrec/llmrec.go - LLM providers
llmpool/pool.go - Notifications
notify/notify.go
Other components
- Security operator
Connections 26
- Security operator → Web console: manages tasks
README.md - Web console → HTTP API: uses API
- HTTP API → Task manager: manages tasks
- Task manager → Event-driven engine: runs tasks
- Event-driven engine → Goal planner: runs planning
README.md - Event-driven engine → Intent workers: dispatches intents
README.md - Goal planner → Exploration graph: reads progress
README.md - Goal planner → Intent workers: dispatches intents
README.md - Intent workers → Security tools: executes tools
README.md - Intent workers → Shared asset graph: writes assets
README.md - Intent workers → Exploration graph: writes results
README.md - Intent workers → Finding reports: records findings
README.md - Security tools → Action guard: checks actions
README.md - Action guard → Approval gates: applies approvals
README.md - Security tools → Scoped egress: sends requests
- Scan ingestion → Shared asset graph: writes assets
- Traffic recorder → Traffic evidence: stores captures
- Finding reports → Traffic evidence: attaches proof
README.md - LLM providers → LLM recorder: records calls
- Event-driven engine → LLM recorder: meters usage
- HTTP API → Exploration graph: reads graph
server/server.go - Findings explorer → Asset tree: renders
web/src/app/(main)/function/findings/page.tsx - Findings explorer → Findings table: renders
web/src/app/(main)/function/findings/page.tsx - Web console → Findings explorer: views findings
- Traffic console → HTTP API: requests traffic
- Event-driven engine → Notifications: emits events