gekleos/bitagent-ui

https://img.shields.io/github/v/release/gekleos/bitagent?sort=semver](https://github.com/gekleos/bitagent/releases) https://img.shields.io/github/actions/workflow/status/gekleos/bitagent/ci.yml?branch=main](https://github.com/gekleos/bitagent/actions) https://img.shields.io/docker/pulls/gekleos/bitagent-ui](https://hub.docker.com/r/gekleos/bitagent-ui) https://img.shields.io/github/license/gekleos/bitagent](https://github.com/gekleos/bitagent/blob/main/LICENSE)

BitAgent

Turn raw DHT noise into ground-truthed torrent metadata for your Sonarr and Radarr stacks.

What BitAgent is:

• A self-hosted, high-performance BitTorrent DHT crawler and content indexer
• A Torznab-compatible provider that speaks natively to Sonarr, Radarr, ***, Lidarr, and Readarr
• A self-improving evidence pipeline that uses *arr webhook feedback to continuously prune false positives

Quick start

Spin up BitAgent in under five minutes. Default authentication uses a simple API key.

bash

# Generate auth secrets

DASHBOARD_API_KEY=$(openssl rand -hex 32)
TORZNAB_API_KEY=$(openssl rand -hex 32)

# Pull the compose file

curl -O https://raw.githubusercontent.com/gekleos/bitagent/main/examples/compose.public.yml

# Edit .env, then:

docker compose -f compose.public.yml up -d

Wait ~3 minutes for the first DHT bootstrap, then open http://localhost:8080 and use the API key to log in.

Full quickstart: https://github.com/gekleos/bitagent/blob/main/docs/quickstart.md

***** strongly recommended.** When BitAgent participates in the DHT, your node's IP address is visible to other peers. Route DHT traffic through a no-log *** that supports port forwarding and set BITAGENT_PEER_PORT to the forwarded port. See https://github.com/gekleos/bitagent/blob/main/docs/legal/disclaimer.md for the full network-isolation recommendation.

Architecture

mermaid
flowchart LR
  arr["*arr suite (Sonarr/Radarr/...)"] -->|Torznab API| tzn["Torznab adapter"]
  tzn --> core["BitAgent core (Go)"]
  core --> dht["DHT crawler"]
  core --> idx["CEL classifier + Postgres"]
  core --> gql["GraphQL API"]
  gql --> dash["Operator dashboard (FastAPI/JS)"]
  arr -->|Webhook on grab| evt["Evidence pipeline"]
  evt --> idx

The Go core orchestrates DHT traffic, applies CEL-based classification, and persists results to Postgres. The Torznab *** translates *arr queries into DHT searches and returns normalized metadata. The evidence pipeline ingests successful download webhooks to prune low-quality releases and recalibrate classifier thresholds.

Configuration

Full reference at https://github.com/gekleos/bitagent/blob/main/docs/configuration.md. Six core env vars cover most deployments:

• DATABASE_URL — Postgres connection string
• DASHBOARD_API_KEY — dashboard auth (set, or auto-generated on first run)
• TORZNAB_API_KEY — Torznab endpoint auth (set this for any public-internet deployment)
• BITAGENT_LOG_LEVEL — debug / info / warn / error
• BITAGENT_DHT_BIND_ADDR — DHT UDP ***d (default :4413)
• TMDB_API_KEY — optional, enables Library poster art

Integrations

Configure your *arr stack by adding a Torznab indexer:

• Sonarr: Indexers → Add → Torznab → URL http://bitagent:3333/torznab + your TORZNAB_API_KEY
• Radarr: same shape
• ***: add as a Newznab provider with the same URL/key
• Lidarr / Readarr: same Torznab pattern

Status

BitAgent v1.0.0 is live. Follow https://github.com/gekleos/bitagent/discussions for roadmap updates and community Q&A.

Roadmap

Tracked in GitHub Discussions. Current focus:

• Multi-region DHT crawling mesh
• CEL rule editor (visual builder in the dashboard)
• Magnet sanitization + torrent health scoring
• Mobile-responsive dashboard
• Native Plex/Jellyfin metadata export

Legal

BitAgent is a metadata indexer, not a download client. The authors accept no liability for copyright infringement or any other harm arising from your use of this software. Operators are solely responsible for complying with applicable copyright, data-protection, and network regulations in their jurisdiction. See https://github.com/gekleos/bitagent/blob/main/docs/legal/disclaimer.md for the full disclaimer.

License & acknowledgments

MIT — see https://github.com/gekleos/bitagent/blob/main/LICENSE.

BitAgent is a 2026 fork of https://github.com/bitmagnet-io/bitmagnet. The upstream provided a sound foundation; we extend our gratitude to those contributors. The DHT protocol and BitTorrent ecosystem are the work of the broader open-source community.