ghostwright/phantom repository overview

⁠Phantom

An autonomous AI co-worker that runs on its own machine, learns from every conversation, and evolves its own capabilities.

Phantom wraps the Claude Agent SDK (Opus/Sonnet) with persistent vector-backed memory, a validated self-evolution engine, and full computer access. It communicates via Slack, sends email from its own address, collects credentials securely, serves web dashboards, schedules tasks, and exposes all capabilities as an MCP server.

⁠Quick Start

# Download the compose file and env template
curl -O https://raw.githubusercontent.com/ghostwright/phantom/main/docker-compose.user.yaml
curl -O https://raw.githubusercontent.com/ghostwright/phantom/main/.env.example

# Configure
cp .env.example .env
# Edit .env with your ANTHROPIC_API_KEY and Slack tokens

# Run
docker compose -f docker-compose.user.yaml up -d

# Verify
curl http://localhost:3100/health

Three containers start automatically: Phantom (the agent), Qdrant (vector memory), and Ollama (local embeddings). First run pulls the embedding model (~270MB) and initializes configuration.

⁠Configuration

Set these in your .env file:

⁠What It Can Do

• Slack conversations - message your Phantom, it responds in threads with full context
• Email from its own address - set a Resend API key and your Phantom sends email as {name}@yourdomain.com
• Secure credential collection - when the agent needs an API key or token, it generates a secure encrypted form instead of asking you to paste secrets in chat
• Web dashboards - the agent builds and serves HTML pages on its own domain
• Scheduled tasks - cron jobs, reminders, recurring reports, all managed conversationally
• Self-evolution - reflects after every conversation, proposes improvements, validates through LLM judges, and applies approved changes
• MCP server - 17+ tools exposed via the Model Context Protocol for other agents and tools to connect
• Full computer access - Bash, Docker, git, file system, network. It can clone repos, spin up databases, install packages

⁠Links

• GitHub⁠
• Documentation⁠
• ghostwright.dev⁠