> ## 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**.

<CardGroup cols={2}>
  <Card title="OMSS‑compliant backend" icon="server-cog">
    CinePro Core follows the OMSS specification to provide a predictable, strongly‑typed interface for discovering and streaming movies and TV shows.
  </Card>

  <Card title="Ecosystem backbone" icon="layers">
    Core powers the broader CinePro ecosystem, including an experimental frontend and CineHome, by exposing a shared HTTP API and data model.
  </Card>
</CardGroup>

## Key features

<CardGroup cols={2}>
  <Card title="Docker‑ready deployment" icon="docker" href="/quickstart#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>

  <Card title="Modular providers" icon="plug" href="/core/configuration/providers">
    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>

  <Card title="Stremio addon support" icon="puzzle" href="/core/configuration/environment#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>

  <Card title="MCP support for AI agents" icon="bot" href="/core/configuration/environment#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>

  <Card title="Caching & performance" icon="gauge" href="/core/configuration/environment#cache-configuration">
    Designed for production‑grade performance with support for in‑memory caching and Redis‑backed caching in containerized deployments.
  </Card>

  <Card title="CineHome integration" icon="hard-drive" href="/cinehome/coming-soon">
    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>

  <Card title="CinePro UI (public beta)" icon="globe" href="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).
  </Card>
</CardGroup>

## Intended use

<Info>
  CinePro Core is intended for **personal, home, and educational use only**.\
  It is not designed or supported for commercial or large‑scale streaming deployments.
</Info>

* 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.**
</Warning>

## Legal and content responsibilities

<Card title="CinePro does not host content" horizontal icon="shield-check">
  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.
</Card>

* 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.

<Danger>
  **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.
</Danger>

## Next steps

<CardGroup cols={2}>
  <Card title="Get started quickly" icon="rocket" href="/quickstart">
    Install dependencies, configure your TMDB API key, and run CinePro Core locally in a few minutes.
  </Card>

  <Card title="Explore the API" icon="square-terminal" href="/core/api-reference/introduction">
    Learn how the OMSS‑style HTTP API is structured and how to fetch movie and TV show sources programmatically.
  </Card>
</CardGroup>