Monitor and manage your GPU nodes on the Cocoon network — live metrics, earnings, and alerts, inside Telegram.

---

Table of contents

• Features
• Architecture
• Tech stack
• Getting started
• License

---

Features

	Feature	Description
📊	Real-time node monitoring	GPU utilization, VRAM, temperature, uptime, and TEE status across all nodes with live-updating metrics.
💰	Earnings dashboard	Daily / weekly / monthly / all-time earnings with trend sparklines and animated counters.
📈	Engagement analytics	A dedicated Python service computes DAU/MAU ratios, retention cohorts, and task-completion rates.
🎛️	Node management	Start, stop, and restart GPU nodes directly from the Mini App.
🔔	Alert system	Telegram notifications when a node goes offline, exceeds a temperature threshold, or earnings drop unexpectedly.
🔗	TON Connect	Wallet linking via the official Telegram WebApp SDK.

---

Architecture

flowchart LR
    TG["Telegram Mini App<br/>React 19 + WebApp SDK"] --> API["Express 5 API<br/>(TypeScript)"]
    API --> DB[(PostgreSQL 17)]
    API --> REDIS[(Redis 7<br/>metric cache)]
    NODES["Cocoon GPU nodes"] --> API
    API --> ANALYTICS["Analytics service<br/>FastAPI · pandas · numpy"]
    API --> BOT["Alert bot<br/>offline / temp / earnings"]
    BOT --> TG

Loading

---

Tech stack

Layer	Technology
Frontend	React 19, TypeScript, Vite 7, Tailwind CSS 4, Zustand, Framer Motion
Telegram	@telegram-apps/sdk-react, @tonconnect/ui-react
Charts	Recharts + inline sparklines
Backend	Express 5 (via tsx), PostgreSQL 17 (pg), Redis 7 (ioredis)
Alerts	Telegram bot (alertBot.ts)
Analytics	Python 3.12, FastAPI, pandas, numpy (port 8080)

---

Getting started

Prerequisites

• Node.js 20+ · Python 3.12+ · PostgreSQL 17 + Redis 7 (or Docker Compose)

Install & run

git clone https://github.com/beepboop2025/cocoon-pulse.git
cd cocoon-pulse
npm install

Run the services (separate terminals):

npm run dev       # frontend  → http://localhost:5173
npm run server    # backend   → http://localhost:3001
npm run bot       # Telegram alert bot

cd analytics && pip install -r requirements.txt && python main.py   # analytics → :8080

Docker Compose

cp .env.example .env     # set Telegram bot token + Cocoon API key
docker compose up --build

---

License

Source-available — free to view, study, and run locally for non-commercial use. Commercial use requires a separate license. See LICENSE.md for the full terms.

---

_{part of the beepboop2025 intelligence stack — systems that make opaque worlds legible}

📈 DragonScope · ⚙ pdf-suite-mcp · snapmock