Freedom251 › Video Downloaders
Hermes

What Hermes is
Hermes is a free, open-source video downloader built for self-hosted deployment. Using yt-dlp, it supports YouTube, Vimeo, TikTok, and more than 1,000 other sites. A web interface and API let users manage downloads, while queued background processing handles playlists and batches asynchronously. The project includes JWT authentication, API-key management, administrator controls, and account management. Self-hosted installations can permit or disable public signup, allowing administrators to control who creates accounts. Interactive Swagger documentation describes the API. Hermes can run from pre-built Docker images or from source with Docker Compose; the documented setup uses SQLite and directories for downloaded and temporary files. The quick start exposes the application on port 3000. For production, the project recommends HTTPS, a strong secret key, restricted CORS origins, disabled public signup for non-personal deployments, and regular updates. It is intended for lawful fair-use media collection.
Who it suits
Hermes suits content creators and technical users who want to run a downloader themselves through a browser or API. It is intended for lawful use of freely available media under fair use.
What it does well
- Supports more than 1,000 sites
- Playlist and batch downloads
- Web interface and API
- JWT and API-key controls
- Free and AGPL-3.0 licensed
What to know first
- Requires self-hosted deployment
- Docker setup uses SQLite storage
- Production security needs manual configuration
- Intended for lawful fair-use media
Verdict
Hermes provides broad site coverage, queued downloads, and administrative controls in a self-hosted package. It is a practical fit for users comfortable managing Docker and production security settings.
Facts from Hermes's own pages
- API
- The project provides an API with interactive Swagger documentation. · github.com, 12 Oct 2026
- Authentication
- It supports JWT tokens, API key management, and admin user control. · github.com, 12 Oct 2026
- Background jobs
- It queues downloads and processes them asynchronously. · github.com, 12 Oct 2026
- Background processing
- Downloads can be queued and processed asynchronously. · github.com, 12 Oct 2026
- Batch downloads
- Yes · github.com, 21 Sept 2026
- Deployment
- Hermes can be run using pre-built Docker images or built from source with Docker Compose. · github.com, 12 Oct 2026
- Device platforms
- Web interface and API; self-hosted Docker deployment · github.com, 21 Sept 2026
- Intended audience
- The README describes Hermes as designed for content creators who want to lawfully use freely available media under fair use. · github.com, 12 Oct 2026
- Intended use
- The project says it is designed for content creators to lawfully use freely available media under fair use and does not endorse piracy, freebooting, or bypassing advertising. · github.com, 12 Oct 2026
- License
- The repository is licensed under AGPL-3.0. · github.com, 12 Oct 2026
- Maker
- The GitHub profile describes TechSquidTV as apps from @KyleTryon and the TechSquidTV community and lists the United States of America. · github.com, 12 Oct 2026
- Playlists
- It can download entire playlists asynchronously. · github.com, 12 Oct 2026
- Playlist downloads
- Yes · github.com, 21 Sept 2026
- Production security
- The project recommends using HTTPS, setting a strong secret key, restricting CORS origins, and keeping Hermes updated. · github.com, 12 Oct 2026
- Purpose
- Hermes is a self-hosted video downloader built on yt-dlp. · github.com, 12 Oct 2026
- Security configuration
- The README recommends a strong secret key, restricting CORS origins, using HTTPS in production, disabling public signup for non-personal deployments, and keeping Hermes updated. · github.com, 12 Oct 2026
- Signup control
- Public signup can be disabled so only administrators can create accounts. · github.com, 12 Oct 2026
- Site support
- It downloads videos from YouTube, Vimeo, TikTok, and more than 1,000 sites. · github.com, 12 Oct 2026
- Storage
- The documented setup uses a SQLite database and directories for downloads and temporary files. · github.com, 12 Oct 2026
- Support
- The README directs users with problems to issue templates for bug, API, frontend, and DevOps issues. · github.com, 12 Oct 2026
- Supported sources
- YouTube,Vimeo,TikTok,and 1,000+ other sites · github.com, 21 Sept 2026
- User management
- Administrators can manage accounts, and signup can be configured for self-hosted deployments. · github.com, 12 Oct 2026
- Web interface and API
- The quick start provides a web app and API documentation, with the default app available on port 3000. · github.com, 12 Oct 2026
Where Hermes stands on Freedom251
- Video Downloaders#130 of 135