mrrobotogit/tiramisu

Tiramisu 是最先进的 BitTorrent 引擎和 FUSE 虚拟文件系统，用于直播到你的私人 Plex 或 Jellyfin 库。MCP 已经准备好支持 Hermes、OpenClaw 和 Claude Code。忘掉 Real-Debrid。

[!注] 这个项目以前叫 GoStream。现在叫 Tiramisu，同一个项目，同样的代码库，只是名字变了。工作方式没有变动，说明中的所有内容依然适用。如果你是从旧安装升级，注意二进制名称、配置路径和 systemd 服务名称也都变了，所以重新运行安装脚本是最简单的方法来适应新布局。

---

Tiramisu 暴露了一个自定义 FUSE 虚拟文件系统，每个 .mkv 文件都是完美的幻觉：看起来像磁盘上的真实文件，但每个字节都是通过按需 BitTorrent 群实时提供。不下载。不使用临时文件。不设存储配额。

BitTorrent 引擎运行于与 FUSE 层*相同的操作系统进程中，通过内存中的io.Pipe()连接。

████████╗ ██╗ ██████╗   █████╗  ███╗   ███╗ ██╗ ███████╗ ██╗   ██╗
╚══██╔══╝ ██║ ██╔══██╗ ██╔══██╗ ████╗ ████║ ██║ ██╔════╝ ██║   ██║
   ██║    ██║ ██████╔╝ ███████║ ██╔████╔██║ ██║ ███████╗ ██║   ██║
   ██║    ██║ ██╔══██╗ ██╔══██║ ██║╚██╔╝██║ ██║ ╚════██║ ██║   ██║
   ██║    ██║ ██║  ██║ ██║  ██║ ██║ ╚═╝ ██║ ██║ ███████║ ╚██████╔╝
   ╚═╝    ╚═╝ ╚═╝  ╚═╝ ╚═╝  ╚═╝ ╚═╝     ╚═╝ ╚═╝ ╚══════╝  ╚═════╝

Tiramisu is the most advanced BitTorrent engine and FUSE virtual filesystem for live streaming to your private Plex or Jellyfin library. MCP ready for Hermes, OpenClaw and Claude Code. Forget Real-Debrid.

[!NOTE] This project used to be called GoStream. It is now Tiramisu, same project, same codebase, just a new name. Nothing about how it works has changed, and everything in this README still applies. If you are upgrading from an older install, note that the binary name, config paths, and systemd service name have all changed too, so a fresh run of the install script is the easiest way to pick up the new layout.

---

Tiramisu exposes a custom FUSE virtual filesystem where every .mkv file is a perfect illusion: it looks like a real file on disk, but every byte is served live from a BitTorrent swarm on demand. No downloading. No temp files. No storage quota.

The BitTorrent engine runs inside the same OS process as the FUSE layer, connected by an in-memory io.Pipe(). When Plex/Jellyfin reads a byte range, there is no HTTP round-trip, no serialization, no proxy overhead, just bytes, flowing directly from peers through RAM to the media server at full speed.

The result: 4K HDR Dolby Vision, fully seekable, starting in 0.1 seconds, even on a Raspberry Pi 4.

This is not a torrent client with a media server bolted on. The FUSE filesystem is the product, custom-built from scratch around the constraints of torrent streaming: non-sequential byte-range requests, multi-gigabyte files that must be seekable at any position, and a Plex/Jellyfin scanner that probes every file in a library of hundreds of titles on startup.

What’s included

The virtual filesystem is the product. Every .mkv in the library is a live