Repository navigation
Releases: rbferreira/seedgrid
Releases · rbferreira/seedgrid
Release list
SeedGrid 0.1.0
SeedGrid orchestrates a BitTorrent seeding infrastructure: a central Control Plane
coordinates several Seed Nodes, each running a Torrent Engine (qBittorrent) and an
Agent; the operator manages one logical cluster from a web Portal.
Cluster and Nodes
- Zero-touch Node onboarding: one command on the new machine, with a join token issued by the
Portal; the Control Plane assigns the BitTorrent port and the Node registers itself. - Heartbeat, inventory and per-Node metrics (disk, I/O, network, peers); Node nicknames;
storage health with a declared dedicated-disk or system-disk mode. - Agent self-update orchestrated from the Portal, with a smoke test before switching binaries.
- Deterministic IPv6 suffix per Node (
::5eed:<N>), so firewall rules survive prefix changes. - Durable command queue (the Agent polls it), executed in order per Node.
Torrents
- Add by magnet or
.torrentupload; a disk-aware Scheduler places each torrent on a Node that
can hold it with a safety margin. - Admission control that shares the tracker's download slots across the cluster, rotating slow
and dead downloads; manual or automatic mode per Node and per cluster. - Migration between Nodes with verification at the destination, cancellation and draining.
- Per-torrent time series, rankings and duplicate detection (Analytics).
Publishing
- Publishing to UNIT3D-family trackers: release-name parsing, metadata from TMDB, IGDB,
Open Library and Google Books, screenshots, and an upload description composed per site, in
the site's own language (English or Brazilian Portuguese). - Shareable site profiles (taxonomy, description layout, image host): discover them from
the site, adjust them, export and import them. Seeprofiles/, including a
template for writing one by hand.
Observability and operations
- Alerts (Node offline, storage, disk full, unreachable Node, IPv6 change, I/O saturation) plus
Prometheus/Alertmanager thresholds, shown in the Portal; domain events and an orchestration
activity feed. - Notifications to Telegram, Discord or a webhook, with filters and a rate cap per channel.
- Audit trail of operator actions; role-based access (Administrator, Publisher, Downloader,
Viewer). - Live settings with hot reload, including per-Node values for Agent and Engine tunables.
Portal and languages
- The Portal is available in English and Brazilian Portuguese; alerts, events, audit
entries and API errors are rendered in the reader's language from codes and data
(ADR-041). Notifications follow the cluster's language setting. - Documentation in both languages (
docs/anddocs/pt-BR/).
Project
- CI runs formatting, vet, lint and tests for every module, plus policy checks: architecture
boundaries, commit message format and the code language (comments, messages and identifiers
in English).