개요

PentAGI(Penetration testing Artificial General Intelligence)는 vxcontrol이 개발한 완전 자율 AI 에이전트 시스템으로, 복잡한 침투 테스트 작업을 자동으로 수행한다. GitHub에서 25.4k 스타, 3.3k 포크를 얻은 오픈소스 프로젝트(MIT 라이선스)다. 프로젝트 홈페이지: pentagi.com

핵심 특징

  • 완전 자율 실행: AI 에이전트가 침투 테스트 단계를 자동 결정·실행, 선택적 실행 모니터링과 지능적 태스크 플래닝으로 신뢰성 향상
  • 안전한 샌드박스 격리: 모든 연산이 Docker 컨테이너 내에서 완전 격리되어 수행
  • 전문 보안 도구 20+ 내장: nmap, metasploit, sqlmap 등 업계 표준 도구 탑재
  • 스마트 메모리 시스템: 연구 결과와 성공 접근법을 장기 저장·재사용 (pgvector 벡터 스토어)
  • 선택적 지식 그래프: Graphiti + Neo4j로 시맨틱 관계 추적과 고급 컨텍스트 이해
  • 웹 인텔리전스: 자체 스크래퍼(격리된 브라우저)로 최신 웹 정보 수집
  • 외부 검색 시스템 연동: Tavily, Firecrawl, Traversaal, Perplexity, DuckDuckGo, Google Custom Search, Sploitus, Searxng
  • 전문가 팀 위임: 연구·개발·인프라 특화 에이전트 위임 시스템 (Execution Monitoring, Task Planning 선택 적용)
  • 종합 관측성: Grafana/Prometheus/VictoriaMetrics/Jaeger/Loki/OpenTelemetry 스택
  • 상세 리포팅: 취약점 리포트와 익스플로이테이션 가이드 자동 생성
  • REST + GraphQL API: Bearer 토큰 인증으로 자동화·통합 지원
  • 10+ LLM 프로바이더 지원: OpenAI, Anthropic, Gemini, Bedrock, Ollama, DeepSeek, GLM, Kimi, Qwen, MiniMax, Mistral, xAI + 커스텀/애그리게이터
  • 셀프 호스팅: 데이터와 배포 완전 제어

아키텍처

컨테이너 아키텍처 (5개 서브시스템)

서브시스템구성 요소
Core ServicesFrontend UI (React+TS), Backend API (Go+GraphQL), Vector Store (PostgreSQL+pgvector), Task Queue, AI Agents (Multi-Agent)
Knowledge Graph (선택)Graphiti API, Neo4j Graph DB
MonitoringGrafana, VictoriaMetrics, Jaeger, Loki, OpenTelemetry
AnalyticsLangfuse, ClickHouse, Redis, MinIO
Security ToolsWeb Scraper (격리 브라우저), PenTest Tools (20+ 샌드박스 실행)

에이전트 상호작용 플로우

  1. Flow Initialization — Orchestrator가 벡터 스토어에서 유사 태스크 조회, 관련 지식 로드
  2. Research Phase — Researcher가 타겟 분석, 유사 케이스 검색, 취약점 쿼리, 발견사항 저장
  3. Planning Phase — Developer가 공격 계획 수립, 익스플로잇/도구 정보 조회
  4. Execution Phase — Executor가 계획 실행, 도구 가이드 로드, 결과 저장

메모리 시스템 3계층

  • Long-term: Vector Store(임베딩), Knowledge Base(도메인 전문성), Tools Knowledge(사용 패턴)
  • Working: Current Context, Active Goals, System State
  • Episodic: Past Actions, Action Results, Success Patterns

고급 에이전트 감독 (Beta)

기능설명설정
Execution MonitoringAdviser(멘토) 자동 개입, 동일 툴 호출 5회/총 10회 임계값 감지, 루프 방지, 대안 전략 제안EXECUTION_MONITOR_ENABLED (기본 false)
Intelligent Task PlanningAdviser가 3-7단계 실행 계획 자동 분해, enricher로 컨텍스트 분석, 스코프 크립 방지AGENT_PLANNING_STEP_ENABLED (기본 false)
Tool Call LimitsGeneral agents 100회, Limited agents 20회 하드 리밋, Reflector로 우아한 종료항상 활성
Reflector Integration3회 툴 호출 실패 시 자동 수정, 실패 패턴 기반 전략적 가이드, 리밋 집행항상 활성

소형 모델(<32B) 권장: Execution Monitoring + Task Planning 동시 활성화 필수. Qwen3.5-27B-FP8 테스트에서 결과 품질 2배 향상, 루프 대폭 감소 확인. 토큰/시간 2-3배 증가 트레이드오프.

배포 및 설정

설치 방식

  1. 인터랙티브 인스톨러 (권장) — Linux/Windows/macOS 바이너리 제공, 시스템 체크·LLM·검색엔진·보안 설정 가이드
  2. 수동 설치 — .env.example 복사→API 키 입력→docker compose up -d

주요 환경 변수

  • COOKIE_SIGNING_SALT, PUBLIC_URL, SERVER_SSL_CRT/KEY — 보안 필수
  • TENANT_ID — 다중 인스턴스 공유 리소스 시 네임스페이스 분리
  • OLLAMA_SERVER_URL, OPEN_AI_KEY, ANTHROPIC_API_KEY 등 — LLM 프로바이더별
  • GRAPHITI_ENABLED, NEO4J_* — 지식 그래프 활성화 시
  • LANGFUSE_*, OTEL_* — 관측성 스택

다중 인스턴스 (TENANT_ID)

여러 PentAGI가 PostgreSQL/Worker/Neo4j/Langfuse 공유 시 스키마·컨테이너명·쿠키·텔레메트리 자동 네임스페이싱. 패턴: ^[a-z][a-z0-9_]{0,31}$.

워커 노드 분리 (프로덕션 권장)

메인 서버와 워커 노드 분리 아키텍처로 Docker-in-Docker TLS 구성, 네트워크 격리, OOB 어택 포트 전용 범위 제공.

API 및 통합

  • GraphQL Playground: /api/v1/graphql/playground
  • Swagger UI: /api/v1/swagger/index.html
  • OpenAPI Spec: /api/v1/swagger/doc.json
  • Python/TypeScript 클라이언트 예제 README에 포함
  • 토큰 관리: Settings → API Tokens에서 생성/폐기/모니터링

한계 및 경계

  • CALDERA 스타일 BAS(Breach and Attack Simulation)나 사전 정의된 캠페인/어택 플랜을 갖춘 적대자 에뮬레이션 제품은 아님
  • 에이전트 작성 공격 스크립트는 개념/미래 작업으로 취급
  • JSON 플로우 리포트 내보내기는 미지원 (웹 뷰, 복사, Markdown, PDF만)
  • 프로바이더 유연성은 내장 프로바이더와 커스텀/OpenAI-호환 엔드포인트로 제공

관련 페이지

출처

원본: github.com/vxcontrol/pentagi — README.md 전체 내용 (2026-10-12 수집)