# rehelios

> rehelios is a hosted video infrastructure platform for developers and AI agents. Upload a video and rehelios transcodes it into adaptive HLS (plus optional MPEG-DASH and progressive MP4), stores it durably, and delivers it from a global CDN with signed playback, subtitles, chapters, analytics, and a REST API. It is fully operable programmatically — by your backend, a CLI, or an AI agent over MCP.

## What it does

- **Upload**: resumable, multipart, direct-to-storage uploads (TUS-compatible). The origin server never handles the bytes. Alternatively, import a video from any public URL — rehelios fetches and transcodes it server-side (`POST /v1/videos/import`).
- **Transcode**: single-pass ffmpeg adaptive bitrate ladder from 240p to 1080p. Output as HLS, optional MPEG-DASH, and progressive MP4.
- **Deliver**: segments cached on a global CDN; manifests kept fresh.
- **Playback URL**: `GET /v1/videos/{id}` returns `playbackUrl` — an absolute HLS master URL ready for any player (append `?token=` from `POST /v1/videos/{id}/playback-token` for private videos). Read this field; do not construct URLs by hand.
- **Secure**: private videos authorized at the edge either by a short-lived signed JWT token (`?token=`) or by a per-org domain allowlist (Referer/Origin, Bunny-style — stable token-less URL that never expires). Cookie-free, so it works in cross-site embeds. Public videos embed via iframe.
- **Captions & chapters**: VTT/SRT subtitles, multi-language, auto-captions; per-video chapter markers; collections.
- **Analytics**: views, watch time, completion rate, top countries per video and account-wide, plus edge bandwidth.
- **API**: REST API with scoped API keys, OpenAPI docs, and HMAC-signed webhooks (video.ready, video.failed, caption.ready).

## For AI agents (CLI + MCP)

rehelios ships one npm package, `@rehelios/cli`, that is both a CLI and an MCP
server, so an agent can put video live on its own. Authentication is the
`REHELIOS_API_KEY` environment variable (`rh_live_…`).

- **CLI**: `npx @rehelios/cli upload ./file.mp4 --wait` uploads and prints a
  ready-to-embed URL. Also `import <url>`, `ls`, `get <id>`, `embed <id>`. Add
  `--json` to any command for machine-readable output.
- **MCP server**: `npx -y @rehelios/cli mcp` (stdio transport). Add it to Claude
  Desktop, Cursor, or Claude Code with the env var set. Tools: `rehelios_upload`,
  `rehelios_import`, `rehelios_list`, `rehelios_get`, `rehelios_get_embed`.
- **Setup guide**: https://rehelios.com/docs

## Pricing

- Storage: $0.01 per GB per month.
- Delivery: $0.005 per GB streamed.
- Encoding: free (no per-minute transcoding charge).
- Monthly minimum: $1.
- Same per-gigabyte billing model as Bunny Stream (not per-minute like Cloudflare Stream).

## Links

- Home: https://rehelios.com
- App / sign up: https://app.rehelios.com
- Docs (CLI + MCP): https://rehelios.com/docs
- API reference (OpenAPI): https://api.rehelios.com/openapi
- npm package: https://www.npmjs.com/package/@rehelios/cli
- Full reference (for AI agents): https://rehelios.com/llms-full.txt

## Positioning

rehelios is an alternative to Cloudflare Stream, Bunny Stream, and Mux for developer teams and AI agents that want per-gigabyte pricing, free encoding, signed playback, MPEG-DASH output, a developer-first REST API, and an agent-native CLI + MCP server — without a sales process or per-seat licensing.