add automated relay count tracking with dual trend charts (#8)

* Add relay count tracking workflow with dual charts

This commit adds:
- New GitHub workflow to track relay counts
- Two charts: BitChat-compatible relays and total functioning relays
- Extended history for both charts (70 days)
- Project structure improvements with scripts and assets directories
- Updated documentation in README.md and other files
- Dependencies in requirements.txt

* Remove overlapping data point labels from relay count charts

* Add .venv to gitignore

* Add relay location maps and automation workflow

* Improve relay maps with proper world map backgrounds using cartopy

* Add relay location map to README

* update readme
This commit is contained in:
lollerfirst
2025-11-01 22:19:32 +01:00
committed by GitHub
parent 83c131a24b
commit 760efc97b1
15 changed files with 11679 additions and 0 deletions
+30
View File
@@ -63,5 +63,35 @@ To change the schedule, seed relay, or enable BitChat filtering in CI, edit the
---
## Relay Count History
These charts show the number of Nostr relay entries in our dataset over time:
### BitChat-Compatible Relays
The chart below shows relays that support BitChat events (kind 20000):
![BitChat-Compatible Relay Count Over Time](assets/bitchat_relay_count_chart.png)
### Total Functioning Relays
The chart below shows all functioning relays discovered during the relay discovery process:
![Total Functioning Relay Count Over Time](assets/total_relay_count_chart.png)
The charts are automatically updated daily to reflect changes in the number of relays and show approximately 70 days of history.
## Global Distribution of Relays
The map below shows the geographical distribution of BitChat-compatible Nostr relays around the world:
![Global Distribution of BitChat-Compatible Nostr Relays](assets/relay_locations_static.png)
Additional visualizations available in this repository:
- **Heatmap**: A density visualization showing relay concentration areas (`assets/relay_locations_heatmap.png`)
- **Interactive Map**: An HTML-based interactive map that allows zooming and clicking on individual relays (`assets/relay_locations_interactive.html`) - download and open in a browser to explore
All maps are automatically updated alongside the relay data.
## Attribution
`nostr_relays.csv` and `relay_discovery_results.json` use a database curated by DBIP, available at https://www.db-ip.com.