Full Platform Terminal Guide
Every command you need to operate the My Squad trading platform — with exact terminal type, working directory, and description. Click any command to copy it.
Setup & Environment
First-time setup and virtual environment management
Project directory: All commands below assume you
cd into the project root first: cd "C:\Users\Leogutierrez777\Desktop\chainlink-bot-1"
Install Dependencies
Sync all dependencies from pyproject.toml
uv sync📋
Installs or updates all Python packages. Run this after pulling new code.
Install as editable package (enables
pump_bot CLI)uv pip install -e .📋
Activate venv manually — bash (git bash / WSL)
source .venv/Scripts/activate📋
Activate venv — PowerShell
.venv\Scripts\Activate.ps1📋
How to open the right terminal
Open PowerShell from Windows
Win+X → "Windows PowerShell" or "Terminal"📋
Open from VS Code (Ctrl+` then select PowerShell)
Ctrl+` → click dropdown → PowerShell📋
Open Git Bash
Right-click Desktop → "Git Bash Here"📋
Open from VS Code (Ctrl+` then select bash)
Ctrl+` → click dropdown → Git Bash📋
Backend Server
FastAPI server on port 8000 — powers the entire web platform
The backend must be running for the web UI to work. Use the emoji-safe command on Windows to avoid crashes.
Start backend (Windows — emoji-safe, recommended)
$env:PYTHONUTF8=1; uv run app.py📋
Start with auto-reload (dev mode)
$env:PYTHONUTF8=1; uv run uvicorn app:app --host 0.0.0.0 --port 8000 --reload📋
Start as hidden background process
Start-Process powershell -WindowStyle Hidden -ArgumentList '-NoProfile -Command "cd \"C:\Users\Leogutierrez777\Desktop\chainlink-bot-1\"; $env:PYTHONUTF8=1; uv run app.py"'📋
Check if port 8000 is in use
netstat -ano | findstr :8000📋
Kill process on port 8000
Stop-Process -Id (Get-NetTCPConnection -LocalPort 8000).OwningProcess -Force📋
Verify backend is working
curl http://localhost:8000/health📋
curl http://localhost:8000/api/status📋
Should return 200 OK with JSON. Then open http://localhost:8000 in your browser.
Sniper Bot
Automated token sniping on pump.fun and letsbonk.fun
Bot configs are in
bots/ folder. The main production config is bot-sniper-2-logs.yaml (0.05 SOL per trade, TP 50% / SL 30%).Run the main bot runner (loads all enabled YAML configs)
uv run src/bot_runner.py📋
Or via installed CLI entry point
pump_bot📋
The bot runner reads all enabled YAML files in
bots/, validates configs, and starts each bot in its own process.Bot Configuration Files (bots/)
📄 bot-sniper-2-logs.yaml — PRODUCTION (enabled)
cat bots/bot-sniper-2-logs.yaml📋
Pump.fun | WebSocket logs | 0.05 SOL | TP 50% / SL 30% | Max hold 120s | YOLO mode ON
📄 bot-sniper-1-geyser.yaml — Geyser (disabled)
cat bots/bot-sniper-1-geyser.yaml📋
Ultra-fast geyser stream. Requires geyser credentials. 0.005 SOL per trade.
📄 bot-sniper-3-blocks.yaml — Block subscription (disabled)
cat bots/bot-sniper-3-blocks.yaml📋
Block subscription listener. Extreme fast mode ON. 0.0001 SOL test amounts.
📄 bot-sniper-4-pp.yaml — PumpPortal / letsbonk
cat bots/bot-sniper-4-pp.yaml📋
Let's Bonk platform via PumpPortal listener. 0.0001 SOL test amounts.
Scalper Bot
High-frequency scalping via web dashboard
Control scalper via API (backend must be running)
curl -X POST http://localhost:8000/api/scalper/start📋
curl -X POST http://localhost:8000/api/scalper/stop📋
curl http://localhost:8000/api/scalper/stats📋
Or use the web UI at localhost:8000/scalper-dashboard
Volume Bot
Intelligent volume trading for My Squad token
Volume bot control via API
curl -X POST http://localhost:8000/api/volume-bot/start📋
curl -X POST http://localhost:8000/api/volume-bot/stop📋
curl http://localhost:8000/api/volume-bot/status📋
Set trade mode (phased/aggressive/conservative)
curl -X POST http://localhost:8000/api/volume-bot/set-mode -H "Content-Type: application/json" -d "{\"mode\":\"phased\"}"📋
Token Discovery Scripts
Listen for newly launched tokens in real-time
WebSocket logs listener (fastest, recommended)
uv run learning-examples/listen-new-tokens/listen_logsubscribe_abc.py📋
Block subscription listener
uv run learning-examples/listen-new-tokens/listen_blocksubscribe.py📋
Geyser stream (ultra-low latency, needs credentials)
uv run learning-examples/listen-new-tokens/listen_geyser.py📋
PumpPortal feed
uv run learning-examples/listen-new-tokens/listen_pumpportal.py📋
Compare listener latency (benchmark all methods)
uv run learning-examples/listen-new-tokens/compare_listeners.py📋
Bonding Curve Scripts
Monitor pump.fun bonding curve progress and migrations
Check bonding curve status for a token (replace TOKEN_ADDRESS)
uv run learning-examples/bonding-curve-progress/get_bonding_curve_status.py TOKEN_ADDRESS📋
Get all graduating tokens (near migration)
uv run learning-examples/bonding-curve-progress/get_graduating_tokens.py📋
Poll bonding curve progress continuously
uv run learning-examples/bonding-curve-progress/poll_bonding_curve_progress.py📋
Compute associated bonding curve PDA
uv run learning-examples/compute_associated_bonding_curve.py📋
Manual Trading Scripts
Direct buy/sell execution for testing and one-off trades
Simple buy
uv run learning-examples/manual_buy.py📋
Optimized buy (CU optimization)
uv run learning-examples/manual_buy_optimized.py📋
Buy with Geyser confirmation
uv run learning-examples/manual_buy_geyser.py📋
Sell tokens
uv run learning-examples/manual_sell.py📋
Mint new token + immediate buy
uv run learning-examples/mint_and_buy.py📋
Buy My Squad token specifically
uv run learning-examples/santa_squad_manual_buy.py📋
Fetch current price of a token
uv run learning-examples/fetch_price.py📋
Clean up token accounts (recover SOL from dust)
uv run learning-examples/cleanup_accounts.py📋
Migration Detection
Listen for pump.fun → Raydium graduation events
uv run learning-examples/listen-migrations/listen_logsubscribe.py📋
uv run learning-examples/listen-migrations/listen_blocksubscribe_old_raydium.py📋
uv run learning-examples/listen-migrations/listen_programsubscribe.py📋
uv run learning-examples/listen-migrations/compare_migration_listeners.py📋
Let's Bonk Scripts
Buy/sell on letsbonk.fun platform
uv run learning-examples/letsbonk-buy-sell/manual_buy_exact_in.py📋
uv run learning-examples/letsbonk-buy-sell/manual_buy_exact_out.py📋
uv run learning-examples/letsbonk-buy-sell/manual_sell_exact_in.py📋
uv run learning-examples/letsbonk-buy-sell/manual_sell_exact_out.py📋
PumpSwap Scripts
Trade on PumpSwap AMM pools
uv run learning-examples/pumpswap/get_pumpswap_pools.py📋
uv run learning-examples/pumpswap/manual_buy_pumpswap.py📋
uv run learning-examples/pumpswap/manual_sell_pumpswap.py📋
Ruflo — AI Agent CLI
60+ agent types, swarm orchestration, persistent memory
Daemon control
ruflo daemon status📋
ruflo daemon start📋
ruflo daemon stop📋
Spawn agents
ruflo agent spawn -t coder --name my-coder📋
ruflo agent spawn -t researcher --name researcher📋
ruflo agent spawn -t security-architect --name sec-audit📋
ruflo agent list📋
ruflo agent kill --all📋
Swarm orchestration
ruflo swarm init --topology hierarchical --max-agents 8 --strategy specialized📋
ruflo swarm status📋
Memory operations
ruflo memory store --key "pattern" --value "example" --namespace agents📋
ruflo memory search --query "agent patterns"📋
ruflo memory list --namespace agents --limit 20📋
Health & diagnostics
ruflo doctor --fix📋
MCP Configuration
Register MCP servers for VS Code and Claude Code CLI
Run
claude mcp commands OUTSIDE of Claude Code sessions — they will fail if run from inside a Claude Code terminal.Add Ruflo to Claude Code CLI
claude mcp add ruflo -- npx -y ruflo@latest mcp start📋
claude mcp list📋
claude mcp remove ruflo📋
VS Code MCP config (already configured at .vscode/mcp.json)
code .vscode/mcp.json📋
API Endpoints
All REST endpoints available at localhost:8000
Backend must be running. All endpoints return JSON.
System
curl http://localhost:8000/health📋
curl http://localhost:8000/api/status📋
curl http://localhost:8000/api/quick-stats📋
Market Data
curl http://localhost:8000/api/market-stats📋
curl http://localhost:8000/api/santa-squad-market-data📋
curl http://localhost:8000/api/bonding-curve-data📋
Wallets & Balances
curl http://localhost:8000/api/wallets📋
curl -X POST http://localhost:8000/api/balance -H "Content-Type: application/json" -d "{}"📋
curl http://localhost:8000/api/wallet-holdings📋
RPC Management
curl http://localhost:8000/api/test-rpc📋
curl http://localhost:8000/api/geyser-status📋
Transaction History
curl http://localhost:8000/api/transaction-history📋
curl http://localhost:8000/api/stats📋
curl http://localhost:8000/api/bot-monitor/performance📋
Wallet Operations
Wallet management and recovery
Never share private keys or .env contents. All keys should live only in .env
Check wallet balance via API
curl -X POST http://localhost:8000/api/balance📋
List all configured wallets
curl http://localhost:8000/api/wallets📋
Open wallet manager UI
open http://localhost:8000/wallet-manager📋
Wallet recovery (if needed)
open http://localhost:8000/wallet-recovery📋
Deployment
Push to GitHub and deploy on Render
Git workflow
git status📋
git add src/ templates/ static/ app.py📋
git commit -m "your message here"📋
git push origin main📋
Render auto-deploys on push to main. Manual trigger:
curl -X POST https://api.render.com/v1/services/$RENDER_SERVICE_ID/deploys -H "Authorization: Bearer $RENDER_API_KEY"📋
Debugging & Logs
Find and fix issues
View backend startup logs (if using log file)
Get-Content logs/backend.log -Tail 50📋
View bot logs
Get-Content logs/ -Tail 100📋
API debug logs
curl http://localhost:8000/api/debug-logs📋
Check Python version
uv run python --version📋
List installed packages
uv pip list📋
Code Quality
Formatting and linting with Ruff
ruff format📋
ruff check📋
ruff check --fix📋