Skip to content

Commit c88314d

Browse files
committed
Add production stories with GIFs, fix architecture diagram centering, Discord and Vigil examples
1 parent e8998ab commit c88314d

File tree

4 files changed

+72
-26
lines changed

4 files changed

+72
-26
lines changed

README.md

Lines changed: 72 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,53 @@ AI agents today are disposable. You open a chat, get an answer, close the tab, a
2727

2828
Phantom takes a different approach: **give the AI its own computer.** A dedicated machine where it installs software, spins up databases, builds dashboards, remembers what you told it last week, and gets measurably better at your job every day. Your laptop stays yours. The agent's workspace is its own.
2929

30-
This is not a chatbot. It is a co-worker that runs on Slack, has its own email address, creates its own tools, and builds infrastructure without asking for permission. One Phantom installed ClickHouse, loaded 28 million rows of data, and built a REST API. Nobody told it to. It decided analytics would help it work better.
30+
This is not a chatbot. It is a co-worker that runs on Slack, has its own email address, creates its own tools, and builds infrastructure without asking for permission. Don't take our word for it - scroll down to see what production Phantoms have actually built.
31+
32+
## What This Actually Looks Like
33+
34+
These are not mockups. They happened on production Phantom instances.
35+
36+
### Built an analytics platform from scratch
37+
38+
A Phantom was asked to help with data analysis. It installed ClickHouse on its own VM, downloaded the full Hacker News dataset, loaded 28.7 million rows spanning 2007-2021, built an analytics dashboard with interactive charts, and created a REST API to query the data. Then it registered that API as an MCP tool so it could use it in future sessions and other agents could query it too.
39+
40+
Nobody asked it to build any of this. It identified analytics as useful and built the entire stack.
41+
42+
<p align="center">
43+
<img src="docs/assets/story-clickhouse.gif" alt="Phantom built a ClickHouse analytics dashboard with 28.7 million rows of Hacker News data" width="800" />
44+
</p>
45+
46+
*28.7 million items. 755K unique authors. 4.3 million stories. Built, loaded, and served by a Phantom on its own machine.*
47+
48+
### Extended itself with a channel it was never built with
49+
50+
Phantom ships with Slack, Telegram, Email, and Webhook channels. It does not ship with Discord. When asked "Can I talk to you on Discord?", the Phantom said: "Not right now. Discord isn't wired up. That said, I could build it."
51+
52+
It explained the Discord Bot API, walked the user through creating a Discord application, provided a magic link for secure token submission, and said: "Once you save it, I'll automatically spin up the container and you'll be live on Discord."
53+
54+
After submitting the token, Phantom went live on Discord. It permanently gained a communication channel it was never designed with.
55+
56+
<p align="center">
57+
<img src="docs/assets/story-discord.png" alt="Phantom built Discord support for itself when asked" width="800" />
58+
</p>
59+
60+
*The agent was honest about what it could not do, then built the capability on the spot.*
61+
62+
### Started monitoring its own infrastructure
63+
64+
A Phantom discovered [Vigil](https://github.com/baudsmithstudios/vigil), a lightweight open-source system monitor with 3 GitHub stars. It understood what Vigil does, integrated it into its existing ClickHouse instance, built a sync pipeline that batch-transfers metrics every 30 seconds, and created a real-time monitoring dashboard showing service health, Docker container status, network I/O, disk I/O, system load, and data pipeline health.
65+
66+
890,450 rows. 25 metrics. Auto-refreshing. The agent is watching its own infrastructure.
67+
68+
<p align="center">
69+
<img src="docs/assets/story-vigil.gif" alt="Phantom monitoring its own infrastructure with Vigil and ClickHouse" width="800" />
70+
</p>
71+
72+
*It found a 3-star open-source project, integrated it into its data pipeline, and built observability for itself.*
73+
74+
---
75+
76+
This is what happens when you give an AI its own computer.
3177

3278
## Quick Start
3379

@@ -79,7 +125,7 @@ You don't need to install developer tools, learn a build system, or figure out h
79125

80126
### Data and Analytics
81127

82-
- **Build your own analytics stack:** One Phantom installed ClickHouse, loaded 28 million rows of Hacker News data, built a REST API to query it, and registered the API as a tool it could use in future sessions. All on its own machine.
128+
- **Build your own analytics stack:** Phantom installs databases, builds ETL pipelines, and registers APIs as MCP tools for future sessions. All on its own machine. (See the ClickHouse story above.)
83129
- **Shareable dashboards:** "Track our PR velocity and show it to the team." Phantom builds an ECharts dashboard, serves it on a public URL with auth, and sends you the link. Your team bookmarks it. They see the same thing you see.
84130
- **Data exploration:** "Load this dataset and let me ask questions about it." Phantom creates a queryable environment on its VM. You ask in plain English, it translates to SQL.
85131

@@ -142,36 +188,36 @@ Because the agent that can only use pre-built tools hits a ceiling. Phantom buil
142188
<div align="center">
143189

144190
```
145-
External Clients
146-
Claude Code | Dashboard | Other Phantoms
147-
|
148-
MCP (Streamable HTTP)
149-
|
191+
External Clients
192+
Claude Code | Dashboard | Other Phantoms
193+
|
194+
MCP (Streamable HTTP)
195+
|
150196
+------------------------------------------+
151-
| PHANTOM (Bun process) |
197+
| PHANTOM (Bun process) |
152198
| |
153-
| Channels Agent Runtime |
154-
| Slack query() + hooks |
155-
| Telegram Prompt Assembler |
156-
| Email base + role + evolved |
157-
| Webhook + memory context |
199+
| Channels Agent Runtime |
200+
| Slack query() + hooks |
201+
| Telegram Prompt Assembler |
202+
| Email base + role + evolved |
203+
| Webhook + memory context |
158204
| CLI |
159205
| |
160-
| Memory System Self-Evolution Engine |
161-
| Qdrant (vector) 6-step pipeline |
162-
| Ollama (embed) 5-gate validation |
163-
| 3 collections LLM judges (optional) |
206+
| Memory System Self-Evolution Engine |
207+
| Qdrant 6-step pipeline |
208+
| Ollama 5-gate validation |
209+
| 3 collections LLM judges (optional) |
164210
| |
165-
| MCP Server Role System |
166-
| 8 universal YAML-first roles |
167-
| + role tools Onboarding flow |
168-
| + dynamic tools Evolution focus |
211+
| MCP Server Role System |
212+
| 8 universal YAML-first roles |
213+
| + role tools Onboarding flow |
214+
| + dynamic Evolution focus |
169215
+------------------------------------------+
170-
| |
171-
+----+----+ +----+----+
172-
| Qdrant | | SQLite |
173-
| Docker | | Bun |
174-
+---------+ +---------+
216+
| |
217+
+---------+ +---------+
218+
| Qdrant | | SQLite |
219+
| Docker | | Bun |
220+
+---------+ +---------+
175221
```
176222

177223
</div>

docs/assets/story-clickhouse.gif

8.17 MB
Loading

docs/assets/story-discord.png

1.66 MB
Loading

docs/assets/story-vigil.gif

9.61 MB
Loading

0 commit comments

Comments
 (0)