Skip to content

Commit f1fbee0

Browse files
Co-MessiCo-Messi
committed
Add CI workflow, growth playbook, CI badge
1 parent 5ae87c2 commit f1fbee0

3 files changed

Lines changed: 227 additions & 0 deletions

File tree

‎.github/workflows/ci.yml‎

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
name: CI
2+
3+
on:
4+
push:
5+
branches: [main]
6+
pull_request:
7+
branches: [main]
8+
9+
jobs:
10+
test:
11+
runs-on: ubuntu-latest
12+
strategy:
13+
matrix:
14+
python-version: ["3.12", "3.13"]
15+
16+
steps:
17+
- uses: actions/checkout@v4
18+
19+
- name: Set up Python ${{ matrix.python-version }}
20+
uses: actions/setup-python@v5
21+
with:
22+
python-version: ${{ matrix.python-version }}
23+
24+
- name: Install dependencies
25+
run: |
26+
pip install -e .
27+
pip install pytest ruff
28+
29+
- name: Lint
30+
run: ruff check src/
31+
32+
- name: Syntax check all Python files
33+
run: |
34+
find src/ -name "*.py" -exec python -c "
35+
import ast, sys
36+
try:
37+
ast.parse(open(sys.argv[1]).read())
38+
except SyntaxError as e:
39+
print(f'FAIL: {sys.argv[1]}: {e}')
40+
sys.exit(1)
41+
" {} \;
42+
43+
- name: Test imports
44+
run: |
45+
python -c "from src.data_layer.hub import HyperDataHub; print('hub: OK')"
46+
python -c "from src.strategies import Strategy, Signal, PaperTrader; print('strategies: OK')"
47+
python -c "from src.strategies.llm_agent import LLMAgent; print('llm: OK')"
48+
python -c "from src.dashboards.liquidation_heatmap import LiquidationHeatmapDashboard; print('heatmap: OK')"

‎GROWTH.md‎

Lines changed: 178 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,178 @@
1+
# HyperData Terminal — Growth Playbook
2+
3+
Ready-to-post content for every platform. Copy-paste and go.
4+
Post in this order, spaced 2 days apart for maximum impact.
5+
6+
---
7+
8+
## Day 1: r/algotrading (180K+ members)
9+
10+
**Title:**
11+
```
12+
I built a free terminal that streams live crypto data from 5 exchanges simultaneously
13+
```
14+
15+
**Body:**
16+
```
17+
Got tired of having 5 browser tabs open for exchange data. Built HyperData Terminal — a Rich TUI that streams live liquidations, order flow, whale positions, and funding rates from Hyperliquid, Binance, Bybit, OKX, and Deribit simultaneously.
18+
19+
Features:
20+
- Liquidation heatmap (like Coinglass, but free and in your terminal)
21+
- CVD order flow analysis
22+
- Whale position tracking from Hyperliquid
23+
- Pluggable paper trading engine — write your own strategy in ~30 lines of Python
24+
- REST API for building your own tools on top
25+
26+
Just `pip install -e . && hyperdata` — interactive menu lets you pick what to view.
27+
28+
Free, open source, Apache 2.0: https://github.com/Co-Messi/HyperData-Terminal
29+
30+
Happy to hear what features would make this useful for your workflow.
31+
```
32+
33+
---
34+
35+
## Day 3: r/hyperliquid (50K+ members)
36+
37+
**Title:**
38+
```
39+
Open-sourced a terminal dashboard with native Hyperliquid WebSocket — liquidation heatmap, whale tracking, CVD
40+
```
41+
42+
**Body:**
43+
```
44+
Built this for my own trading setup — streams directly from Hyperliquid's WebSocket API.
45+
46+
What it shows:
47+
- Liquidation heatmap — see exactly where positions will get wiped, for every asset
48+
- Whale tracker — largest open positions, their PnL, liquidation distance
49+
- Positions closest to liquidation (the "danger zone")
50+
- CVD order flow from Binance
51+
- Multi-exchange liquidation stream (HL + Binance + Bybit + OKX)
52+
53+
One command: `hyperdata`
54+
55+
No API key needed. Free. https://github.com/Co-Messi/HyperData-Terminal
56+
57+
Built with Python + Rich. Would love feedback from the HL community.
58+
```
59+
60+
---
61+
62+
## Day 5: r/Python (1.2M members)
63+
64+
**Title:**
65+
```
66+
Show r/Python: Built a Rich TUI that streams live crypto market data from 5 exchanges via WebSocket
67+
```
68+
69+
**Body:**
70+
```
71+
Project: HyperData Terminal — a Rich-based TUI that connects to 5 exchange WebSocket feeds simultaneously and renders live market data in your terminal.
72+
73+
Tech stack:
74+
- Python 3.12+
75+
- Rich for TUI rendering (Live, Layout, Panel, Table)
76+
- aiohttp for async WebSocket connections
77+
- SQLite for persistence
78+
- 14 data components running concurrently via asyncio
79+
80+
The interesting engineering challenge was keeping 5 concurrent WebSocket connections alive while rendering at 4fps without flickering. Rich's Live context manager + careful async lifecycle management made it work.
81+
82+
Also includes a pluggable paper trading engine where you subclass a Strategy class and implement one method.
83+
84+
`pip install -e . && hyperdata`
85+
86+
Code: https://github.com/Co-Messi/HyperData-Terminal
87+
88+
Feedback welcome — especially on the Rich TUI patterns. First time building something this complex with Rich.
89+
```
90+
91+
---
92+
93+
## Day 7: Hacker News (Show HN)
94+
95+
**Title:**
96+
```
97+
Show HN: HyperData Terminal – stream live crypto data from 5 exchanges in your terminal
98+
```
99+
100+
**URL:** `https://github.com/Co-Messi/HyperData-Terminal`
101+
102+
**Best time to post:** Tuesday–Thursday, 8–9 AM PST
103+
104+
---
105+
106+
## Twitter/X Post (post same day as Reddit)
107+
108+
```
109+
Just shipped HyperData Terminal — open-source Rich TUI that streams live data from @HyperliquidX @binance @Bybit_Official @OKX @DeribitExchange simultaneously.
110+
111+
Liquidation heatmap, whale tracking, CVD order flow, paper trading — all in your terminal.
112+
113+
Free: github.com/Co-Messi/HyperData-Terminal
114+
115+
[ATTACH GIF/SCREENSHOT]
116+
```
117+
118+
---
119+
120+
## Product Hunt (Day 10+, after Reddit/HN traction)
121+
122+
**Tagline:** `Bloomberg Terminal vibes, $0 price tag`
123+
124+
**Description:**
125+
```
126+
HyperData Terminal streams live crypto market data from 5 exchanges directly into your terminal. Track liquidations, whale positions, order flow, and funding rates — all updating in real-time via WebSocket.
127+
128+
Built for traders who live in the terminal. No browser needed, no subscription, no API keys. Just pip install and go.
129+
130+
Features:
131+
- 6 live dashboards (liquidation heatmap, whale tracker, CVD, market overview, and more)
132+
- Paper trading engine with pluggable strategies
133+
- LLM agent integration (GPT, Ollama, Groq)
134+
- REST API for building custom tools
135+
- Apache 2.0 licensed
136+
```
137+
138+
**Category:** Developer Tools > CLI Tools
139+
140+
---
141+
142+
## Discord Communities
143+
144+
Post in #share-your-project or equivalent channels:
145+
146+
| Server | Angle |
147+
|--------|-------|
148+
| Hyperliquid Discord | "Built a terminal with native HL WebSocket support" |
149+
| Freqtrade Discord | "Complements your bot with live market data terminal" |
150+
| Python Discord | "Rich TUI showcase — 5 concurrent WebSocket feeds" |
151+
152+
---
153+
154+
## GitHub Awesome Lists (submit PRs)
155+
156+
- awesome-trading
157+
- awesome-python
158+
- awesome-systematic-trading (4K stars)
159+
- awesome-rich (if exists)
160+
161+
---
162+
163+
## Automation You Can Set Up
164+
165+
1. **Buffer/Typefully** — schedule all social posts in advance
166+
2. **GitHub star-history** — add star-history.com badge to README after hitting 100 stars
167+
3. **GitHub Discussions** — enable in repo settings for community Q&A
168+
4. **GitHub social preview** — upload the swoosh logo as social preview image (Settings → Social preview)
169+
170+
---
171+
172+
## Key Rules
173+
174+
- **Never post multiple subreddits on the same day** (looks like spam)
175+
- **Respond to EVERY comment** within hours (engagement drives algorithm)
176+
- **Lead with the problem you solved**, not the features
177+
- **GIF/screenshot is mandatory** for Twitter and Reddit
178+
- **Don't say "AI-powered"** on r/algotrading (they hate AI hype). Say "pluggable strategy engine"

‎README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@
44

55
**Real-time crypto market intelligence, right in your terminal.**
66

7+
[![CI](https://github.com/Co-Messi/HyperData-Terminal/actions/workflows/ci.yml/badge.svg)](https://github.com/Co-Messi/HyperData-Terminal/actions)
78
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
89
[![Python 3.12+](https://img.shields.io/badge/Python-3.12+-green.svg)](https://python.org)
910
[![Exchanges](https://img.shields.io/badge/Exchanges-5-orange.svg)](#data-sources)

0 commit comments

Comments
 (0)