Unlimited Cloud Seedbox: Setup High-Speed Torrent Downloader App

Project Specifications & Benefits

• $0 Operational Bandwidth: Hugging Face covers all download and upload traffic bandwidth for free.
• Gigabit Download Speeds: Processes magnet transfers at gigabit server rates, far exceeding local ISP throttles.
• On-The-Fly Video Streaming: Stream video segments directly in your browser without waiting for the full torrent to finish downloading.
• Bypass Local Bans: Bypasses ISP torrent protocol blocks, firewalls, and port restrictions.

How It Works: Cloud Torrent Streaming

Instead of downloading files directly to your local drive over a throttled connection, the web dashboard submits the magnet link to our Node.js container on Hugging Face. The WebTorrent engine downloads the file segments from the BitTorrent network at edge speeds, caches them in the container storage, and exposes them as a seekable stream using HTTP range requests:

Pipeline Architecture: Torrents are fetched via Hugging Face's server network and streamed directly to the browser.

The Seedbox Server Code (index.js)

The Node.js server (index.js) manages active torrent connections, calculates download/upload speeds, and serves file streams over HTTP range requests:

import express from 'express';

import WebTorrent from 'webtorrent';



const app = express();

const PORT = process.env.PORT || 7860;

const client = new WebTorrent();



app.post('/api/add', (req, res) => {

 const { magnet } = req.body;

 if (!magnet) return res.status(400).json({ error: "Magnet link required" });



 const existing = client.get(magnet);

 if (existing) return res.json(getTorrentMetadata(existing));



 client.add(magnet, (torrent) => {

 res.json(getTorrentMetadata(torrent));

 });

});



app.get('/stream/:infoHash/:fileIndex', (req, res) => {

 const torrent = client.get(req.params.infoHash);

 const file = torrent.files[parseInt(req.params.fileIndex)];

 const range = req.headers.range;



 if (!range) {

 res.writeHead(200, {

 'Content-Length': file.length,

 'Content-Type': 'application/octet-stream',

 'Content-Disposition': `attachment; filename="${file.name}"`

 });

 file.createReadStream().pipe(res);

 } else {

 const parts = range.replace(/bytes=/, "").split("-");

 const start = parseInt(parts[0], 10);

 const end = parts[1] ? parseInt(parts[1], 10) : file.length - 1;



 res.writeHead(206, {

 'Content-Range': `bytes ${start}-${end}/${file.length}`,

 'Accept-Ranges': 'bytes',

 'Content-Length': (end - start) + 1,

 'Content-Type': 'video/mp4'

 });

 file.createReadStream({ start, end }).pipe(res);

 }

});

Manual Docker Setup & Deployment

To configure the server environment, build a custom Dockerfile and deploy to Hugging Face Spaces:

Step 1: Configure Dockerfile

Create a Dockerfile in your local project folder to define the container runtime. It is mandatory to expose port 7860 for Hugging Face Spaces to read the web page interface:

FROM node:18-slim

WORKDIR /app

COPY package*.json ./

RUN npm install

COPY . .

EXPOSE 7860

ENV PORT=7860

CMD ["node", "index.js"]

Step 2: Deploy to Hugging Face Spaces

Deploy the container directly to the cloud without local CLI terminal configurations:

1. Create a free account on Hugging Face.
2. Go to your profile page and click Create Space.
3. Name your space, select Docker as the SDK, and choose the Blank template.
4. Click Files > Add File > Upload files and upload your local index.js, package.json, and Dockerfile.
5. The container will automatically build and start the server, making your Seedbox live at https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME.

Terminal Setup: Compiling package dependencies and Docker configurations locally.

Seedbox Dashboard Interface Overview

The web client dashboard displays active downloads, bandwidth speed in MB/s, progress bars, and file selectors. Clicking 'Stream/Download' on any video file initiates seeking-compatible streaming instantly inside your browser:

Seedbox Client Web UI: View download speeds, progress, and stream media files directly in browser.

Frequently Asked Questions (FAQs)