⚡ 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