A real operating system. Built live on pump.fun. Powered by Claude Code.
An Ubuntu-based operating system with a custom shell, AI-native tooling, and a full crypto-native desktop environment. Not a concept, not a mockup — it boots.
Built using Claude Code, Anthropic's agentic coding tool. Streamed live on pump.fun.
First public drop. Runs on any VM software — download, mount, boot.
What's included:
- Custom desktop environment on Ubuntu 24.04 + GNOME
- pump.fun wallpaper with candlestick chart
- Pixel art dock icons
- PumpShell — custom terminal (crypto-themed commands coming in Beta 2)
- DexBrowser — browser with pump.fun as homepage
- McapCalc — market cap calculator
- Whitepaper.pump — read-only OS whitepaper viewer
Coming in Beta 2:
- WalletVault — Solana wallet terminal
- TokenForge — launch tokens directly from terminal
- PumpAgent — AI-powered trading bot and wallet agent
- PumpShell custom commands (
mint,burn,mcap,moon, etc.)
Requirements: VMware or VirtualBox · 4 GB RAM minimum · 20 GB disk
Setup:
1. Download and unzip the archive
2. VMware → File → Open → select the .ovf file
3. Power on the VM
4. Login password: pumpos
PumpAgent is a local AI agent daemon designed to run 24/7 on PumpOS, built on OpenClaw — the open-source personal AI agent framework. It connects to your Solana wallet and trades through the PumpPortal API, and can be controlled remotely through messaging platforms like WhatsApp, Telegram, and Discord, using OpenClaw's gateway as the interface layer.
How it works under the hood:
PumpAgent uses two PumpPortal interfaces. For trading (buy, sell, token creation), it sends HTTP requests to the PumpPortal Transaction API at pumpportal.fun/api/trade-local, which returns serialized Solana transactions that are signed locally — your private keys never leave your machine. For real-time monitoring (new launches, trades, whale activity), it connects to the PumpPortal WebSocket at wss://pumpportal.fun/api/data and subscribes to event streams like subscribeNewToken and subscribeAccountTrade.
Token creation goes through pump.fun's own IPFS endpoint (pump.fun/api/ipfs) for metadata storage, then PumpPortal handles the on-chain transaction.
What it can do:
- Buy and sell tokens via messaging commands
"buy 0.5 SOL of [mint address]" - Launch tokens through the pump.fun API from your phone
"launch $TICKER, name, [image]" - Auto-generate token metadata with AI or leave blank
- Run persistent trading strategies
"buy 0.1 SOL into anything that hits 50% bonding in under 5 minutes" - Monitor pump.fun for new launches, velocity anomalies, whale movements via WebSocket streams
- Copy trading, sniper mode, rug protection
- Daily digest of top movers delivered to your chat
Supported pools: pump · raydium · pump-amm · launchlab · auto
Supported channels: Telegram · Discord · WhatsApp · Slack · Signal
base → Ubuntu 24.04 LTS
kernel → Linux 6.x
shell → PumpShell (custom, written in C — commands planned)
ai layer → PumpAgent (systemd daemon, planned)
trading api → PumpPortal (pumpportal.fun, third-party)
data stream → PumpPortal WebSocket (wss://pumpportal.fun/api/data)
config → ~/.pumpagent/
filesystem → PumpFS (planned)
scheduler → DexRouter (planned)
PumpShell currently launches as a standard terminal. The following crypto-themed commands will be added in Beta 2:
help # list all commands
ls # list tokens in LiquidityPool
mint # create new token
burn # delete token
mcap # memory market cap stats
top # process leaderboard
moon # ASCII rocket animation
degen # random degen wisdom
rug # shutdown| App | Status | Description |
|---|---|---|
| PumpShell | ✅ shipped | Custom terminal (commands coming in Beta 2) |
| DexBrowser | ✅ shipped | Browser with pump.fun homepage |
| McapCalc | ✅ shipped | Market cap calculator |
| Whitepaper.pump | ✅ shipped | Read-only OS whitepaper |
| WalletVault | 🔧 planned | Solana wallet terminal |
| TokenForge | 🔧 planned | Token creation terminal |
| WalletSpy | 🔧 planned | Smart money tracker |
| MetaRadar | 🔧 planned | Narrative scanner |
| PnLShell | 🔧 planned | Portfolio dashboard |
| PumpAgent | 🔧 planned | AI agent manager |
Everything is open source. Every commit pushed live.
# Build PumpShell
cd shell/
gcc -Wall -O2 -o pumpshell pumpshell.c
sudo cp pumpshell /usr/local/bin/
# Generate wallpaper
cd wallpaper/
pip3 install Pillow
python3 generate.pyStack: Ubuntu 24.04 · C · Python · Claude Code
- Beta 1 — Desktop environment + PumpShell (base terminal) + 4 native apps
- Beta 2 — PumpShell custom commands + WalletVault + TokenForge + PumpAgent
- Beta 3 — Bootable ISO (no VM required)
- v1.0 — Full PumpOS release with all native apps
PumpOS is built with the help of Claude Code, Anthropic's command-line coding agent. Claude Code lives in the terminal, understands the full codebase, and helps with everything from writing C code for PumpShell to generating the desktop environment config — all through natural language.
The project uses a CLAUDE.md file at the repo root to give Claude Code persistent context about the project structure, build commands, and coding conventions across sessions.
MIT — fork it, build on it, ship it.
Built in public. Open source. Degen forever. 💊