mrkeyoor.com_
Wed 09 Sept 02:43 UTC
Self-Hostedevaluationupdated 09 Sept 2026

gopeed review

Gopeed is a free, open-source download manager built with a Go backend and a Flutter frontend. It combines HTTP, HTTPS, BitTorrent, magnet, and ed2k downloads in one app, with a self-hosted web UI, CLI, REST API, and an MCP endpoint for AI agents. It solves the problem of needing separate tools for direct downloads, torrents, and browser integration.

trackingstars / 7d
Verdict

Our build took 94 seconds and 36 of 45 tests passed, so Gopeed is a capable download manager with a not-quite-green main branch. Use the stable v1.9.3 binaries for daily work; the MCP integration is unique and worth trying if you want AI-driven downloads. If you need a rock-solid torrent daemon, qBittorrent or aria2 may fit better, but for an all-in-one downloader with automation, Gopeed is compelling.

We ran it

Install✓ · 91s404 packages
Build✓ · 94s
Tests✗ · 188s36 passed · 9 failed of 45 (go test)
Repo1076 files~55,684 lines of source · 8.7 MB · 4 CI workflows · Dockerfile

Answers from our run

Does gopeed build from source?

Dependencies installed in 91 seconds (404 packages), and the build succeeded in 94 seconds. We cloned commit 6568498 into a clean Debian container with 3 CPUs and no project-specific setup.

Do gopeed's tests pass?

Not all of them: 36 of 45 passed and 9 failed when we ran the project's own test command (go test). Some failures need services or credentials a bare container does not have.

Who should not use gopeed?

Users who only need a pure command-line torrent daemon and do not want a GUI

What are the alternatives to gopeed?

aria2, Motrix, qBittorrent. Our build took 94 seconds and 36 of 45 tests passed, so Gopeed is a capable download manager with a not-quite-green main branch.

Setup4/5Prebuilt binaries and go install; source build needs Go+Flutter+cgo
Docs4/5Multilingual README covers features, AI tools, build; website docs
Community4/5Active: last push 2026-09-08, 26k stars; 333 open issues
Maturity3/5Stable release but main-branch tests failed 36/45 in our run

Who it’s for

Users who want one app for HTTP, torrent, magnet, and ed2k downloads on desktop, mobile, or web
Self-hosters who want a download server with a web UI and Docker deployment
Automation enthusiasts who need a REST API, CLI, webhooks, or post-download scripts
AI tinkerers who want to control downloads from an AI agent through MCP
People who dislike Electron and want a native Flutter UI with lower resource usage

Who it’s NOT for

Users who only need a pure command-line torrent daemon and do not want a GUI
Teams that cannot use GPL-3.0 licensed code in proprietary products
Anyone who wants a rock-solid main branch; our test run had 9 failures out of 45
Users who prefer a mature, torrent-focused client with RSS and search plugins, like qBittorrent
Developers who want to build from source without installing Flutter and cgo toolchains

Setup reality

We cloned the repo at commit 6568498 on 2026-09-08 in a sandbox with 3 CPUs, 8 GB RAM, and a golang:1.24-bookworm image. Installation succeeded in 91 seconds and pulled 404 packages. Building the Go binary succeeded in 94 seconds. The test run failed after 188 seconds: 36 of 45 tests passed. The final log lines show a failure in pkg/rest, specifically TestPauseAllAndContinueALLTasks, and the rest package took 152.562 seconds. The README implies a simple setup with Go 1.25+ and Flutter 3.41+, but a full desktop or mobile build also needs a cgo toolchain; mobile builds require gomobile. Prebuilt binaries for stable and beta releases avoid that work, but if you want to run from source, expect more moving parts than the README's two-line environment list suggests.

Background

Gopeed is a download manager built with a Go backend and Flutter frontend, available for Windows, macOS, Linux, Android, iOS, and the web. It wraps HTTP, HTTPS, BitTorrent, magnet, and ed2k downloads into one interface, with the optional self-hosted web UI, CLI, REST API, and MCP endpoint. The repo has 26,189 stars and is licensed GPL-3.0. The latest stable release is v1.9.3 from 2026-03-18, and a 2.0.0 beta was available as of the last push on 2026-09-08. The README is fully available in English, and the project also offers Chinese, Japanese, and other translations.

What happened when we ran it

We cloned the repo at commit 6568498 on 2026-09-08 in a sandbox with 3 CPUs, 8 GB RAM, and a golang:1.24-bookworm image. Installation succeeded in 91 seconds and pulled 404 packages. Building the Go binary succeeded in 94 seconds. The test run, however, failed after 188 seconds: 36 of 45 tests passed. The final log lines show a failure in github.com/GopeedLab/gopeed/pkg/rest, specifically TestPauseAllAndContinueALLTasks (13.30s), and the full rest package took 152.562s. Other packages passed, including pkg/download, pkg/download/engine, and pkg/mcpserver. The repo has four CI workflow files, a Dockerfile, and a compose file, but no tests directory. We did not diagnose the cause beyond the log; it may be timing or environment specific. This is worth knowing if you plan to run Gopeed from source.

Strengths

The feature list is broad. Gopeed combines multi-connection HTTP transfers with BitTorrent DHT, uTP, Web Seeds, selective file downloads, tracker management, and seeding limits based on ratio or time. It also supports ed2k. Task management includes pause, resume, retry, batch operations, search, filter by status, categories, and recovery after restart. The UI is rendered natively with Flutter, not Electron or a WebView shell, which should keep memory and CPU use lower. The README says it follows system theme or light/dark with eight accent colors and adapts to phones, tablets, and resizable desktop windows. It is available in 20+ languages. Browser extensions send downloads from Chrome, Edge, Firefox, and other compatible browsers. JavaScript extensions add support for video platforms, AI model hubs, cloud storage services, and other sources. A REST API, CLI, authenticated web UI, webhooks, and post-download scripts allow automation. There is also a GitHub mirror option, proxy and header/User-Agent customization, notifications, and archive extraction.

The MCP and AI angle

The README details an MCP endpoint for AI agents, with nine tools such as resolve_task, create_task, list_tasks, get_task, pause_task, continue_task, and delete_task. This means you can connect a compatible AI agent and manage downloads with natural language, for example "Download the latest Gopeed client for Windows." The MCP server passed our test run in pkg/mcpserver. This is a differentiator compared with most download managers. If you need a download tool that an agent can drive, Gopeed is one of the few with built-in MCP support.

Weaknesses and rough edges

The main-branch test failure is the biggest concern from our run. Nine of 45 tests failed, all in the rest package's pause/continue behavior. The stable release v1.9.3 may not have that failure, but it means the current development branch is not consistently green. The repo has 333 open issues; 26,189 stars suggest popularity, but a large open issue count can mean maintainer attention is spread thin. The GPL-3.0 license is fine for personal use but may be a barrier for commercial embedding. Building the desktop frontend requires Flutter 3.41+ and a cgo toolchain; mobile builds require gomobile and cgo. For users who only want prebuilt binaries, this is irrelevant, but for source builds, it is more setup than a pure Go tool. The 2.0.0 beta introduces a redesigned interface and FFI communication, but it is explicitly incomplete and unstable. The beta and stable channels are separate, and stable users will not be moved automatically.

Community health

The repository is active. The last push was 2026-09-08, the day before this review. The latest stable release v1.9.3 came on 2026-03-18, and there is a public beta v2.0.0-beta.1. Four CI workflows run tests and badges. The project has a Discord, WeChat account, and donation link. The 333 open issues are not alarming for a repo with 26,189 stars, but they are not tiny either. The trendshift badge suggests rising popularity. Overall, the community appears healthy and responsive, though the beta period means the project is in transition.

Where it fits in a real stack

Gopeed can serve as a desktop app for interactive downloads, a headless daemon via CLI or REST API, or a self-hosted download server with Docker. Its MCP endpoint places it in AI assistant workflows: an agent can create and monitor downloads without a human touching the app. For pure headless multi-protocol downloading, aria2 is lighter and more scriptable. For a polished GUI that is not Flutter, Motrix is a similar cross-protocol option but does not have MCP. For torrent-heavy use, qBittorrent has more mature torrent features like RSS and search plugins. In our sandbox, Gopeed built in 94 seconds but left us with a failing rest test, so if you plan to rely on the REST API, you may want to run the stable binary rather than build from main.

Alternatives

ProjectWhat it isPick it when
aria2A lightweight, headless multi-protocol download utility with JSON-RPCyou need a scriptable daemon without a GUI and do not care about MCP integration
Motrix gh↗An Electron-based cross-platform download manager with a clean UIyou want a more polished desktop app and do not need REST/MCP automation
qBittorrent gh↗A full-featured open-source BitTorrent client with a web UIyour workload is mostly torrents and you need mature RSS, search, and seeding features

What people are saying

  1. [velocity-scout] GopeedLab/gopeed

Sources

  1. GopeedLab/gopeed GitHub repository
  2. Gopeed official website

More self-hosted reviews

httpsms · FlClash · zulip · mediamtx · toolhive · HAMi · the whole board →