Real-time activity monitoring and visualization for blockchain ecosystems.
Hyperbeats is a lightweight analytics visualization service. It aggregates activity metrics from multiple blockchain repositories and exposes them as embeddable SVG/PNG widgets for README files, dashboards, and documentation.
- Multi-repository aggregation from GitHub
- Real-time metric updates
- Customizable themes (light, dark, hyperkit, mint)
- SVG and PNG output formats
- Embeddable widgets for READMEs
- Multi-layer caching for performance
- WebSocket support for live dashboards
# Get activity chart
curl "https://beats.hyperionkit.xyz/api/v1/chart/activity?repos=owner/repo&timeframe=7d&format=svg"
# Get raw metrics
curl "https://beats.hyperionkit.xyz/api/v1/metrics/aggregate?repos=owner/repo&timeframe=30d"Input (Repos/APIs)
|
Aggregation Engine
|
Metric Calculation
|
SVG/PNG Rendering
|
HTTP Endpoint
|
Embed in README/Dashboard
|
Real-time Display
GitHub Repository Activity
- Input: Repository name
- Output: Contributions chart
- Use: Show ecosystem activity in README
Multi-Repo Aggregation
- Input: Multiple repositories
- Output: Combined activity heatmap
- Use: Organization-wide metrics
Blockchain dApp Metrics
- Input: TVL data from deployed dApps
- Output: Growth chart over time
- Use: Project documentation
Points/Rewards Tracker
- Input: User points from smart contract
- Output: Community leaderboard
- Use: Gamify contributions
| Endpoint | Description |
|---|---|
/api/v1/chart/activity |
Generate activity chart |
/api/v1/chart/chain-activity |
Multi-chain comparison |
/api/v1/chart/tvl |
TVL tracker |
/api/v1/chart/points-leaderboard |
Points leaderboard |
/api/v1/metrics/aggregate |
Raw metrics data |
| Parameter | Values | Default |
|---|---|---|
repos |
Repository names | Required |
timeframe |
1d, 7d, 30d, 90d, 1y | 7d |
format |
svg, png | svg |
theme |
light, dark, hyperkit, mint | light |
width |
Number | 800 |
height |
Number | 400 |
| Theme | Background | Primary | Use Case |
|---|---|---|---|
| light | #ffffff | #3182ce | Light mode READMEs |
| dark | #1a202c | #63b3ed | Dark mode READMEs |
| hyperkit | #0f1419 | #2186b5 | HyperKit branded |
| mint | #f0fdf4 | #10b981 | Fresh green aesthetic |
| Metric | Target |
|---|---|
| First request | under 2s |
| Cached request (Redis) | under 50ms |
| Cached request (CDN) | under 100ms |
| Cache hit rate | above 85% |
| API uptime | 99.5%+ |
Backend
- Python 3.11+
- FastAPI
- PostgreSQL
- Redis
- Puppeteer (PNG rendering)
Frontend
- Next.js 14
- TypeScript
- Tailwind CSS
- D3.js / Plotly
Infrastructure
- Vercel (frontend)
- Render (backend)
- Cloudflare CDN
- Prometheus / Grafana
- Fork the repository
- Create your feature branch (
git checkout -b feature/your-feature) - Commit your changes (
git commit -m 'Add your feature') - Push to the branch (
git push origin feature/your-feature) - Open a Pull Request
This project is licensed under the MIT License. See LICENSE for details.
- GitHub Issues: hyperbeats/issues
- Discord: #hyperbeats-support