> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cinepro.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction to CinePro Core

> Learn how CinePro Core, an OMSS-compliant TypeScript streaming backend, aggregates third-party providers into a single unified API for movies and TV.

## What is CinePro Core?

CinePro Core is the foundational backend service of the CinePro ecosystem, built in TypeScript on top of the [Open Media Streaming Standard (OMSS) for movies and TV shows](https://github.com/omss-spec/omss-spec).\
It acts as **a unified scraping and streaming engine that aggregates multiple third‑party providers into a single, consistent API**.

> [card] OMSS‑compliant backend
>
> CinePro Core follows the OMSS specification to provide a predictable, strongly‑typed interface for discovering and streaming movies and TV shows.

> [card] Ecosystem backbone
>
> Core powers the broader CinePro ecosystem, including an experimental frontend and CineHome, by exposing a shared HTTP API and data model.

## Key features

> [card] [Docker‑ready deployment](https://docs.cinepro.cc/quickstart.md#docker-recommended)
>
> Ship CinePro Core as a container. Official multi‑architecture images are published to GitHub Container Registry (ghcr.io/cinepro-org/core); run the latest version with one command `docker run -p 3000:3000 --name cinepro-core -e TMDB_API_KEY=your-tmdb-key ghcr.io/cinepro-org/core:latest`!

> [card] [Modular providers](https://docs.cinepro.cc/core/configuration/providers.md)
>
> CinePro maintains multiple streaming providers that fan out across different third‑party sites in parallel, decrypt and aggregate results, and return a unified list of playable sources.
> Providers live in the [`src/providers`](https://github.com/cinepro-org/core/tree/main/src/providers) directory and can be extended without changing the core server!

> [card] [Stremio addon support](https://docs.cinepro.cc/core/configuration/environment.md#param-stremio-addon)
>
> CinePro can expose a Stremio addon manifest at `/stremio/manifest.json`. Enable it by setting `STREMIO_ADDON=true` in your environment.

> [card] [MCP support for AI agents](https://docs.cinepro.cc/core/configuration/environment.md#param-mcp-enabled)
>
> CinePro Core is the **first streaming backend to ever support the Model Context Protocol (MCP)**, letting AI agents query stream sources directly. Enable it by setting `MCP_ENABLED=true` in your environment. ([News](https://github.com/omss-spec/framework#:~:text=Additionally%2C%20this%20is,using%20AI%20assistants.))

> [card] [Caching & performance](https://docs.cinepro.cc/core/configuration/environment.md#cache-configuration)
>
> Designed for production‑grade performance with support for in‑memory caching and Redis‑backed caching in containerized deployments.

> [card] [CineHome integration](https://docs.cinepro.cc/cinehome/coming-soon.md)
>
> Integrates with the CineHome services to automate downloading and organizing media to your own storage (such as a NAS or home server). \[Coming soon!]

> [card] [CinePro UI (public beta)](https://ui.cinepro.cc)
>
> Pair your CinePro Core instance with the [CinePro UI](https://ui.cinepro.cc) — a browser frontend that connects to your server via its OMSS API. On startup, CinePro Core prints a banner with a ready-to-use link of the form `https://ui.cinepro.cc/?omssurl=<your-instance-url>`. The UI is in public testing and contributions are welcome at [cinepro-org/ui](https://github.com/cinepro-org/ui).

## Intended use

> [!NOTE]
>
> CinePro Core is intended for **personal, home, and educational use only**.\
> It is not designed or supported for commercial or large‑scale streaming deployments.

* Run CinePro Core on your own hardware (for example, a home server or NAS).
* Treat the codebase as a starting point for your own experiments and custom scrapers.

> [!WARNING]
>
> **Do not use CinePro Core as a commercial streaming platform or a hosted content service.**\
> The maintainers do not provide SLAs, scaling guarantees, or legal guidance for production‑grade usage. **It is not secure for public hosting by default.**

## Legal and content responsibilities

> [card] CinePro does not host content
>
> CinePro Core does **not** host, upload, or store any video files.\
> It only discovers and aggregates links that are already publicly available on third‑party sites.

* You are solely responsible for how you use CinePro Core and which providers you enable.
* Ensure that your usage complies with all applicable laws and regulations in your jurisdiction.

> [!CAUTION]
>
> **Nothing in this documentation constitutes legal advice.**
> If you are unsure whether your use of CinePro Core is lawful, consult a qualified legal professional before proceeding.

## Next steps

> [card] [Get started quickly](https://docs.cinepro.cc/quickstart.md)
>
> Install dependencies, configure your TMDB API key, and run CinePro Core locally in a few minutes.

> [card] [Explore the API](https://docs.cinepro.cc/core/api-reference/introduction.md)
>
> Learn how the OMSS‑style HTTP API is structured and how to fetch movie and TV show sources programmatically.


## Related topics

- [Setup CinePro/UI](https://docs.cinepro.cc/ui/setup.md)
- [CinePro UI - Public Beta](https://docs.cinepro.cc/ui/notice.md)
- [CineHome](https://docs.cinepro.cc/cinehome/coming-soon.md)
- [Ecosystem Overview](https://docs.cinepro.cc/ecosystem/overview.md)
- [Development Status](https://docs.cinepro.cc/core/general-information/development.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.