[Skip to content](https://github.com/g0ldyy/comet#start-of-content)

You signed in with another tab or window. [Reload](https://github.com/g0ldyy/comet) to refresh your session.You signed out in another tab or window. [Reload](https://github.com/g0ldyy/comet) to refresh your session.You switched accounts on another tab or window. [Reload](https://github.com/g0ldyy/comet) to refresh your session.Dismiss alert

{{ message }}

[g0ldyy](https://github.com/g0ldyy)/ **[comet](https://github.com/g0ldyy/comet)** Public

- Sponsor







# Sponsor g0ldyy/comet























##### GitHub Sponsors

[Learn more about Sponsors](https://github.com/sponsors)







[![@g0ldyy](https://avatars.githubusercontent.com/u/153996346?s=80&v=4)](https://github.com/g0ldyy)



[g0ldyy](https://github.com/g0ldyy)



[g0ldyy](https://github.com/g0ldyy)



[Sponsor](https://github.com/sponsors/g0ldyy)









##### External links





![ko_fi](https://github.githubassets.com/assets/ko_fi-53a60c17e75c.svg)



[ko-fi.com/ **g0ldyy**](https://ko-fi.com/g0ldyy)









[Learn more about funding links in repositories](https://docs.github.com/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/displaying-a-sponsor-button-in-your-repository).




[Report abuse](https://github.com/contact/report-abuse?report=g0ldyy%2Fcomet+%28Repository+Funding+Links%29)

- [Notifications](https://github.com/login?return_to=%2Fg0ldyy%2Fcomet) You must be signed in to change notification settings
- [Fork\\
151](https://github.com/login?return_to=%2Fg0ldyy%2Fcomet)
- [Star\\
993](https://github.com/login?return_to=%2Fg0ldyy%2Fcomet)


main

[**5** Branches](https://github.com/g0ldyy/comet/branches) [**193** Tags](https://github.com/g0ldyy/comet/tags)

[Go to Branches page](https://github.com/g0ldyy/comet/branches)[Go to Tags page](https://github.com/g0ldyy/comet/tags)

Go to file

Code

Open more actions menu

## Folders and files

| Name | Name | Last commit message | Last commit date |
| --- | --- | --- | --- |
| ## Latest commit<br>[![g0ldyy](https://avatars.githubusercontent.com/u/153996346?v=4&size=40)](https://github.com/g0ldyy)[g0ldyy](https://github.com/g0ldyy/comet/commits?author=g0ldyy)<br>[Merge pull request](https://github.com/g0ldyy/comet/commit/060a8a25f042c1b855a01ed5ba78b74715993f24) [#595](https://github.com/g0ldyy/comet/pull/595) [from ViieeS/fix/multi-title-and-anime-mapping](https://github.com/g0ldyy/comet/commit/060a8a25f042c1b855a01ed5ba78b74715993f24)<br>Open commit detailssuccess<br>5 days agoJun 29, 2026<br>[060a8a2](https://github.com/g0ldyy/comet/commit/060a8a25f042c1b855a01ed5ba78b74715993f24) · 5 days agoJun 29, 2026<br>## History<br>[1,847 Commits](https://github.com/g0ldyy/comet/commits/main/) <br>Open commit details<br>[View commit history for this file.](https://github.com/g0ldyy/comet/commits/main/) 1,847 Commits |
| [.github](https://github.com/g0ldyy/comet/tree/main/.github ".github") | [.github](https://github.com/g0ldyy/comet/tree/main/.github ".github") | [chore: remove platforms specification from Docker build workflow](https://github.com/g0ldyy/comet/commit/70a275843844d57acb8b231c3222f8f872c5e91b "chore: remove platforms specification from Docker build workflow  Eliminated the hardcoded 'platforms' input in the docker-build-push.yml workflow to streamline the configuration for non-main branch pushes.") | 4 months agoMar 18, 2026 |
| [comet](https://github.com/g0ldyy/comet/tree/main/comet "comet") | [comet](https://github.com/g0ldyy/comet/tree/main/comet "comet") | [fix(anime): handle list imdb\_id from Fribb](https://github.com/g0ldyy/comet/commit/a26cc5cd02f2ef2878ea47df1af949c6bde96e40 "fix(anime): handle list imdb_id from Fribb") | last weekJun 28, 2026 |
| [deployment](https://github.com/g0ldyy/comet/tree/main/deployment "deployment") | [deployment](https://github.com/g0ldyy/comet/tree/main/deployment "deployment") | [feat: enhance admin and configuration session management with secure …](https://github.com/g0ldyy/comet/commit/6c0e943847cb1980a2fdf6ded7af28d77d51b645 "feat: enhance admin and configuration session management with secure token handling and improved session validation") | 5 months agoFeb 17, 2026 |
| [docs](https://github.com/g0ldyy/comet/tree/main/docs "docs") | [docs](https://github.com/g0ldyy/comet/tree/main/docs "docs") | [feat(cometnet): make websocket compression configurable](https://github.com/g0ldyy/comet/commit/79a681c3aaf14ab2d78cf8dbdd7ac32a5633e757 "feat(cometnet): make websocket compression configurable") | 3 months agoApr 26, 2026 |
| [kodi](https://github.com/g0ldyy/comet/tree/main/kodi "kodi") | [kodi](https://github.com/g0ldyy/comet/tree/main/kodi "kodi") | [docs: improve documentation](https://github.com/g0ldyy/comet/commit/80cd761592a5c5314ca58d95e1bab5c392292565 "docs: improve documentation") | 5 months agoFeb 20, 2026 |
| [scripts](https://github.com/g0ldyy/comet/tree/main/scripts "scripts") | [scripts](https://github.com/g0ldyy/comet/tree/main/scripts "scripts") | [fix: enhance error handling in StremThru class for missing download l…](https://github.com/g0ldyy/comet/commit/0ebe670979eb4998b22e8a27fb5246b2b8b6e4f3 "fix: enhance error handling in StremThru class for missing download links and update error type in generate_status_videos.py") | 5 months agoFeb 16, 2026 |
| [.env-sample](https://github.com/g0ldyy/comet/blob/main/.env-sample ".env-sample") | [.env-sample](https://github.com/g0ldyy/comet/blob/main/.env-sample ".env-sample") | [feat(cometnet): make websocket compression configurable](https://github.com/g0ldyy/comet/commit/79a681c3aaf14ab2d78cf8dbdd7ac32a5633e757 "feat(cometnet): make websocket compression configurable") | 3 months agoApr 26, 2026 |
| [.gitignore](https://github.com/g0ldyy/comet/blob/main/.gitignore ".gitignore") | [.gitignore](https://github.com/g0ldyy/comet/blob/main/.gitignore ".gitignore") | [Add uv.lock and unignore it](https://github.com/g0ldyy/comet/commit/f2adf77728cb5eb11c02612a61f4edfc86d73f5d "Add uv.lock and unignore it") | 4 months agoMar 18, 2026 |
| [.python-version](https://github.com/g0ldyy/comet/blob/main/.python-version ".python-version") | [.python-version](https://github.com/g0ldyy/comet/blob/main/.python-version ".python-version") | [chore: update Python version and dependencies in Dockerfile and pypro…](https://github.com/g0ldyy/comet/commit/3f2898f247861a3563443edff8b380f8b5017428 "chore: update Python version and dependencies in Dockerfile and pyproject.toml  - Bumped Python version from 3.11 to 3.13 in .python-version and updated the Dockerfile to use the new base image. - Added mimalloc2 to the Dockerfile dependencies for improved memory allocation. - Updated the required Python version in pyproject.toml to reflect the change.") | 4 months agoMar 15, 2026 |
| [CHANGELOG.md](https://github.com/g0ldyy/comet/blob/main/CHANGELOG.md "CHANGELOG.md") | [CHANGELOG.md](https://github.com/g0ldyy/comet/blob/main/CHANGELOG.md "CHANGELOG.md") | [chore(main): release 2.54.1](https://github.com/g0ldyy/comet/commit/f8ba1e3db6c4b1962ddc9b7d65fa43e15d8d9def "chore(main): release 2.54.1") | 3 months agoApr 27, 2026 |
| [Dockerfile](https://github.com/g0ldyy/comet/blob/main/Dockerfile "Dockerfile") | [Dockerfile](https://github.com/g0ldyy/comet/blob/main/Dockerfile "Dockerfile") | [fix: update miniupnpc dependency and Dockerfile cache configuration](https://github.com/g0ldyy/comet/commit/c31bfe16707c46354b420dd8cdbc6a4e48ecad52 "fix: update miniupnpc dependency and Dockerfile cache configuration  Removed the exclusion of miniupnpc version 2.3.3 in pyproject.toml and uv.lock, updating to the latest version. Adjusted the Dockerfile to make the cache mount identifier platform-specific for improved build performance.") | 4 months agoMar 18, 2026 |
| [LICENSE](https://github.com/g0ldyy/comet/blob/main/LICENSE "LICENSE") | [LICENSE](https://github.com/g0ldyy/comet/blob/main/LICENSE "LICENSE") | [Refactor pool manifest handling for verification and deterministic or…](https://github.com/g0ldyy/comet/commit/b7bfd37383ab995266d9727da08f23476d6af3f2 "Refactor pool manifest handling for verification and deterministic ordering, simplify the reputation system by removing several metrics, and add specific handling for zero-sized torrents in gossip") | 6 months agoJan 18, 2026 |
| [README.md](https://github.com/g0ldyy/comet/blob/main/README.md "README.md") | [README.md](https://github.com/g0ldyy/comet/blob/main/README.md "README.md") | [remove useless readme section](https://github.com/g0ldyy/comet/commit/cba3906d6a53685c5dfb730d53e997db8fcda931 "remove useless readme section") | 2 months agoMay 12, 2026 |
| [pyproject.toml](https://github.com/g0ldyy/comet/blob/main/pyproject.toml "pyproject.toml") | [pyproject.toml](https://github.com/g0ldyy/comet/blob/main/pyproject.toml "pyproject.toml") | [feat: switch to the Rust filename parser](https://github.com/g0ldyy/comet/commit/d12f80cf9dea7b391aceed6ee012122410522e52 "feat: switch to the Rust filename parser") | 4 months agoMar 18, 2026 |
| [uv.lock](https://github.com/g0ldyy/comet/blob/main/uv.lock "uv.lock") | [uv.lock](https://github.com/g0ldyy/comet/blob/main/uv.lock "uv.lock") | [fix: update miniupnpc dependency and Dockerfile cache configuration](https://github.com/g0ldyy/comet/commit/c31bfe16707c46354b420dd8cdbc6a4e48ecad52 "fix: update miniupnpc dependency and Dockerfile cache configuration  Removed the exclusion of miniupnpc version 2.3.3 in pyproject.toml and uv.lock, updating to the latest version. Adjusted the Dockerfile to make the cache mount identifier platform-specific for improved build performance.") | 4 months agoMar 18, 2026 |
| View all files |

## Repository files navigation

# ☄️ Comet

[Permalink: ☄️ Comet](https://github.com/g0ldyy/comet#%EF%B8%8F-comet)

[![](https://camo.githubusercontent.com/159088255a36c6285952b9cf95d66923f81ac93972ec24de247ade301daed38b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446973636f72642d4a6f696e25323055732d3538363546323f7374796c653d666c61742d737175617265266c6f676f3d646973636f7264266c6f676f436f6c6f723d7768697465)](https://discord.com/invite/UJEqpT42nb)[![](https://camo.githubusercontent.com/18c296be129f9ccfedc5775993f4edde97d2e4b74d25288b82c51de54b4eb662/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f537472656d696f2d4164646f6e2d3742334645343f7374796c653d666c61742d737175617265266c6f676f3d737472656d696f266c6f676f436f6c6f723d7768697465)](https://stremio-addons.net/addons/comet)[![](https://camo.githubusercontent.com/455ec79181a420fbd4b67d171a73cc71cfd33d62642021fce09f02f24b6baafc/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4b6f64692d4164646f6e2d3137423245373f7374796c653d666c61742d737175617265266c6f676f3d6b6f6469266c6f676f436f6c6f723d7768697465)](https://github.com/g0ldyy/comet/blob/main/kodi/README.md)

![](https://camo.githubusercontent.com/dfb8a85324529c7b73dc0186a51ca1cc1128bda396c543ada90c018632d0a2c8/68747470733a2f2f736f6369616c6966792e6769742e63692f67306c6479792f636f6d65742f696d6167653f6465736372697074696f6e3d3126666f6e743d496e74657226666f726b733d31266c616e67756167653d31266e616d653d31266f776e65723d31267061747465726e3d536f6c6964267374617267617a6572733d31267468656d653d4461726b)

# Features

[Permalink: Features](https://github.com/g0ldyy/comet#features)

- **CometNet**: Decentralized P2P network for automatic torrent metadata sharing ( [documentation](https://github.com/g0ldyy/comet/blob/main/docs/cometnet/README.md))
- **Kodi Support**: Dedicated official add-on with automatic updates ( [documentation](https://github.com/g0ldyy/comet/blob/main/kodi/README.md))
- Proxy Debrid Streams to allow simultaneous use on multiple IPs!
- IP-Based Max Connection Limit
- Administration Dashboard with Bandwidth Manager, Metrics and more...
- Supported Scrapers: Jackett, Prowlarr, Torrentio, Zilean, MediaFusion, Debridio, StremThru, AIOStreams, Comet, Jackettio, TorBox, Nyaa, BitMagnet, TorrentsDB, Peerflix, DMM and SeaDex
- Caching system ft. SQLite / PostgreSQL
- Blazing Fast Background Scraper
- Debrid Account Scraper: Scrape torrents directly from your debrid account library
- [DMM](https://github.com/debridmediamanager/hashlists) Ingester: Automatically download and index Debrid Media Manager hashlists
- Smart Torrent Ranking powered by [TPR](https://github.com/g0ldyy/torrent-parse-rank)
- Proxy support to bypass debrid restrictions
- Real-Debrid, All-Debrid, Premiumize, TorBox, Debrid-Link, Debrider, EasyDebrid, OffCloud and PikPak supported
- Direct Torrent supported
- [Kitsu](https://kitsu.io/) support (anime)
- Adult Content Filter
- ChillLink Protocol support

# Installation

[Permalink: Installation](https://github.com/g0ldyy/comet#installation)

To customize your Comet experience to suit your needs, please first take a look at all the [environment variables](https://github.com/g0ldyy/comet/blob/main/.env-sample)!

## Self Hosted

[Permalink: Self Hosted](https://github.com/g0ldyy/comet#self-hosted)

### From source (developers)

[Permalink: From source (developers)](https://github.com/g0ldyy/comet#from-source-developers)

- Clone the repository and enter the folder



```
git clone https://github.com/g0ldyy/comet
cd comet
```

- Install dependencies



```
pip install uv
uv sync
```

- Start Comet



```
uv run python -m comet.main
```


### Docker / production-style setup

[Permalink: Docker / production-style setup](https://github.com/g0ldyy/comet#docker--production-style-setup)

Use the dedicated documentation:

- Beginner step-by-step: [docs/beginner/01-get-started-docker.md](https://github.com/g0ldyy/comet/blob/main/docs/beginner/01-get-started-docker.md)
- Full documentation index: [docs/README.md](https://github.com/g0ldyy/comet/blob/main/docs/README.md)

# CometNet (P2P Network)

[Permalink: CometNet (P2P Network)](https://github.com/g0ldyy/comet#cometnet-p2p-network)

Comet transforms your Comet instance from an isolated scraper into a participant in a collaborative network. Instead of each instance independently discovering the same torrents, CometNet allows instances to share their discovered **metadata** (hashes, titles, etc.) with each other in a decentralized way. **No actual files are shared.**

Key benefits:

- **Improved Coverage**: Receive torrent metadata discovered by other nodes.
- **Reduced Load**: Less redundant scraping across the network.
- **Trust Pools**: Optional closed groups for trusted metadata sharing.

For more information on how to setup and configure CometNet, please refer to the [CometNet Documentation](https://github.com/g0ldyy/comet/blob/main/docs/cometnet/README.md).

## Support the Project

[Permalink: Support the Project](https://github.com/g0ldyy/comet#support-the-project)

Comet is a community-driven project, and your support helps it grow! 🚀

- ❤️ **Donate** via [GitHub Sponsors](https://github.com/sponsors/g0ldyy) or [Ko-fi](https://ko-fi.com/g0ldyy) to support development
- ⭐ **Star the repository** here on GitHub
- ⭐ **Star the add-on** on [stremio-addons.net](https://stremio-addons.net/addons/comet)
- 🐛 **Contribute** by reporting issues, suggesting features, or submitting PRs

## About

Stremio's fastest torrent/debrid search add-on.


### Resources

[Readme](https://github.com/g0ldyy/comet#readme-ov-file)

### License

[GPL-3.0 license](https://github.com/g0ldyy/comet#GPL-3.0-1-ov-file)

### Uh oh!

There was an error while loading. [Please reload this page](https://github.com/g0ldyy/comet).

[Activity](https://github.com/g0ldyy/comet/activity)

### Stars

[**993**\\
stars](https://github.com/g0ldyy/comet/stargazers)

### Watchers

[**16**\\
watching](https://github.com/g0ldyy/comet/watchers)

### Forks

[**151**\\
forks](https://github.com/g0ldyy/comet/forks)

[Report repository](https://github.com/contact/report-content?content_url=https%3A%2F%2Fgithub.com%2Fg0ldyy%2Fcomet&report=g0ldyy+%28user%29)

## Sponsor this project

- [![@g0ldyy](https://avatars.githubusercontent.com/u/153996346?s=64&v=4)](https://github.com/g0ldyy)[**g0ldyy** Goldy](https://github.com/g0ldyy)[Sponsor @g0ldyy](https://github.com/sponsors/g0ldyy)

- ![ko_fi](https://github.githubassets.com/assets/ko_fi-53a60c17e75c.svg)[ko-fi.com/ **g0ldyy**](https://ko-fi.com/g0ldyy)

[Learn more about GitHub Sponsors](https://github.com/sponsors)

## [Packages\  1](https://github.com/users/g0ldyy/packages?repo_name=comet)

- [comet](https://github.com/users/g0ldyy/packages/container/package/comet)

### Uh oh!

There was an error while loading. [Please reload this page](https://github.com/g0ldyy/comet).

## [Contributors\  28](https://github.com/g0ldyy/comet/graphs/contributors)

- [![@g0ldyy](https://avatars.githubusercontent.com/u/153996346?s=64&v=4)](https://github.com/g0ldyy)
- [![@github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=64&v=4)](https://github.com/apps/github-actions)
- [![@AshukoZioko](https://avatars.githubusercontent.com/u/65336305?s=64&v=4)](https://github.com/AshukoZioko)
- [![@funkypenguin](https://avatars.githubusercontent.com/u/1524686?s=64&v=4)](https://github.com/funkypenguin)
- [![@Riushda](https://avatars.githubusercontent.com/u/45129008?s=64&v=4)](https://github.com/Riushda)
- [![@MunifTanjim](https://avatars.githubusercontent.com/u/8050659?s=64&v=4)](https://github.com/MunifTanjim)
- [![@thelastblt](https://avatars.githubusercontent.com/u/166474022?s=64&v=4)](https://github.com/thelastblt)
- [![@xick](https://avatars.githubusercontent.com/u/7095376?s=64&v=4)](https://github.com/xick)
- [![@davidemarcoli](https://avatars.githubusercontent.com/u/69892203?s=64&v=4)](https://github.com/davidemarcoli)
- [![@herndlm](https://avatars.githubusercontent.com/u/5738896?s=64&v=4)](https://github.com/herndlm)
- [![@wrefgtzweve](https://avatars.githubusercontent.com/u/69946827?s=64&v=4)](https://github.com/wrefgtzweve)
- [![@CoolMintChocolate](https://avatars.githubusercontent.com/u/70276626?s=64&v=4)](https://github.com/CoolMintChocolate)
- [![@YagUber](https://avatars.githubusercontent.com/u/20715993?s=64&v=4)](https://github.com/YagUber)
- [![@pvbhanuteja](https://avatars.githubusercontent.com/u/33227278?s=64&v=4)](https://github.com/pvbhanuteja)

[\+ 14 contributors](https://github.com/g0ldyy/comet/graphs/contributors)

## Languages

- [Python83.5%](https://github.com/g0ldyy/comet/search?l=python)
- [HTML16.3%](https://github.com/g0ldyy/comet/search?l=html)
- Other0.2%

You can’t perform that action at this time.