⚡ Quickstart Guide ⭐ GitHub Repository
🛡️ AI-POWERED OFFENSIVE & DEFENSIVE SECURITY HUB

Autonomous AI Command Center
for Pentesting & Security Research

PHANTOM is an unconstrained, self-improving multi-agent framework equipped with 25 autonomous tools, real-time WebSockets, Scrapling anti-bot scrapers, 4-tier vector memory, and full LLM compatibility.

$ curl -fsSL https://raw.githubusercontent.com/OmYarewar/PHANTOM/main/install.sh | bash
phantom@command-center:~
Tap quick commands (Mobile/Touch friendly):
phantom@ghost:~$ phantom start
[+] Starting PHANTOM Command Center v1.0.0... [+] Server running on http://localhost:1337 [+] WebSocket stream active on ws://localhost:1337 [+] Vector Store (@xenova/transformers + SQLite FTS5) initialized. [+] Multi-Agent Task Graph: Orchestrator, Planner, Threat Modeler, Compliance Ready. [+] 25 Autonomous Security & Reconnaissance Tools Registered. 👻 PHANTOM is online! Open http://localhost:1337 to interact.
phantom@ghost:~$

Engineered for Unbounded Security Operations

Everything needed for automated penetration testing, security audit, and deep web research in a single dashboard.

🛡️

Multi-Agent Task Graph

Specialized parallel sub-agents (Threat Modeling, Log Analysis, Compliance Review, Code Auditing) coordinated by an Orchestrator DAG planner.

Unbounded Recursive Execution

No strict turn limits. PHANTOM recursively invokes tools, installs missing CLI packages, parses stdout/stderr, and resolves roadblocks autonomously.

🧠

4-Tier Hybrid Vector Memory

Combines SQLite persistence, local `@xenova/transformers` embeddings, FTS5 lexical search, and Reciprocal Rank Fusion (RRF) for long-term recall.

🕷️

Scrapling Anti-Bot Scraping

Integrates Scrapling engine to bypass anti-bot challenges, solve Cloudflare turnstiles, and render JavaScript heavy web applications.

🔑

Secure Sudo Injection

Encrypted one-time sudo password handling allowing seamless system-level diagnostic execution (`nmap`, `tcpdump`, `iptables`) safely.

🤖

Any LLM Backend

Plug-and-play support for OpenAI, OpenRouter (100+ models like DeepSeek & Claude), Ollama (local free inference), and custom OpenAI APIs.

PHANTOM Core Architecture

How components collaborate between the WebSocket UI, Multi-Agent Task Graph, Memory Engine, and Tool Execution Sandbox.

1. UI & WebSockets
Vite Frontend, Live Matrix Canvas, Real-time JSON/terminal stream
2. Orchestrator & Task Graph
DAG Planner, Threat Modeler, Compliance Agent & Code Reviewer
3. Tool Execution Engine
25 Autonomous Tools, Sudo Handler, Scrapling, Python Sandbox
4. Memory & Vector Store
SQLite Store, Transformers Vector Embeddings, FTS5 Hybrid RRF

25 Built-in Autonomous Tools

Explore the built-in capabilities available to the LLM agent during security operations.

system

execute_command

Executes arbitrary terminal bash commands with auto-sudo password injection and non-blocking streaming execution.

system

read_file

Reads exact file content with line ranges and UTF-8 encoding support across the system workspace.

system

write_file

Creates or overwrites system files, scripts, reports, and code modules with automatic directory creation.

system

list_directory

Inspects directory contents, file sizes, permissions, and structure recursively.

system

install_tool

Auto-installs missing dependencies across package managers (`apt`, `pacman`, `pip`, `npm`, `cargo`, `go`).

recon

web_request

Sends custom HTTP requests (GET, POST, PUT, DELETE) with custom headers, query params, and payload analysis.

recon

search_web

Performs real-time web searches using DuckDuckGo to obtain fresh CVE details, exploits, and documentation.

recon

scrape_webpage

Fetches HTML pages, strips clutter, and extracts clean structured text and links.

recon

scrapling_fetch

Advanced anti-bot scraper utilizing Scrapling to solve Cloudflare Turnstile, JavaScript rendering, and browser fingerprinting.

code

python_execute

Executes Python scripts inline in isolated sub-processes for data analysis, payload generation, and math.

memory

save_memory

Stores critical findings, target IPs, credentials, or architectural patterns into 4-tier vector memory.

memory

recall_memory

Performs hybrid Reciprocal Rank Fusion (RRF) search across long-term stored agent memories.

memory

get_memory_stats

Retrieves memory store health, total record counts, vector index status, and top recalled entities.

code

edit_source_code

Self-modification capability allowing PHANTOM to edit its own tools, agents, and server logic on the fly.

memory

save_trace

Logs execution steps and operational timelines for self-optimization and audit reporting.

recon

jina_read_url

Converts complex web pages and documentation into clean, structured Markdown format via Jina AI.

media

youtube_search

Searches YouTube video databases for security talk presentations, demos, and walkthroughs.

media

youtube_get_subtitles

Extracts complete video transcripts and subtitles for fast LLM summarization.

media

rss_read_feed

Parses RSS and Atom security feeds to track zero-days, advisories, and threat intelligence updates.

media

v2ex_browse

Browses V2EX technology community threads and developer discussions.

media

reddit_crawl

Searches subreddits (`r/netsec`, `r/cybersecurity`) for recent vulnerability advisories and discussions.

media

linkedin_crawl

Crawls public tech posts, company updates, and article content for OSINT research.

Setup & Deployment Guide

Detailed guides for running PHANTOM via 1-Line installer, manual npm clone, Docker, or CLI configuration.

1-Line Universal Linux & macOS Installation

Run the universal automated installer script directly in any terminal:

BASH
curl -fsSL https://raw.githubusercontent.com/OmYarewar/PHANTOM/main/install.sh | bash

The installer automatically verifies Node.js 18+, clones/updates PHANTOM into ~/.phantom, installs native bindings (sharp, better-sqlite3), configures path symlinks, and sets up shell aliases.

Manual Developer Installation

If you want to contribute or modify the PHANTOM codebase:

BASH
# 1. Clone repository from GitHub git clone https://github.com/OmYarewar/PHANTOM.git cd PHANTOM # 2. Install Node.js dependencies npm install # 3. Copy default configuration template cp .env.example .env # 4. Launch in development mode (Express server + Vite UI hot reload) npm run dev # 5. Run test suite npm test

Environment Configuration (.env)

PHANTOM supports any OpenAI-compatible LLM endpoint. Configure your keys in .env or via the Web UI Settings panel:

ENV
# ─── OpenAI ─── API_BASE_URL=https://api.openai.com/v1 API_KEY=sk-your-openai-key MODEL_ID=gpt-4o # ─── OpenRouter (Access to 100+ Models) ─── API_BASE_URL=https://openrouter.ai/api/v1 API_KEY=sk-or-v1-your-key MODEL_ID=deepseek/deepseek-chat # ─── Ollama (Local & Free) ─── API_BASE_URL=http://localhost:11434/v1 API_KEY=ollama MODEL_ID=llama3

Docker Compose Deployment

Deploy PHANTOM in an isolated, containerized environment with zero local setup:

DOCKER
docker compose up --build

Once built, open http://localhost:3000 in your web browser.

CLI Executable Options

After running install.sh, use the phantom CLI command anywhere in your terminal:

CLI
# Start PHANTOM production server (Default port: 1337) phantom start # Start development mode (Express server + Vite UI hot reload) phantom dev # Specify custom port phantom start --port 8080 # View help menu phantom --help