Initial commit: KiraTV IPTV proxy server

Full-stack IPTV management system with Xtream Codes API compatibility,
multi-account provider fan-out, Jellyfin local library integration,
real-time dashboard, EPG support, and A/V-sync-safe stream recovery.

README.md

@@ -0,0 +1,44 @@
+# KiraTV
+
+Sistema de proxy y gestión IPTV con soporte multiusuario y fan-out de streams.
+
+## Stack
+
+- **Backend**: Python 3.13 + FastAPI + asyncio
+- **Base de datos**: PostgreSQL 17 + SQLAlchemy 2 + Alembic
+- **Cache / estado**: Redis 8
+- **Frontend**: React 18 + Vite + TailwindCSS
+- **Proxy inverso**: Nginx
+
+## Características
+
+- Compatible con API Xtream Codes (TiviMate, Smarters, IPTV Pro…)
+- Fan-out de streams: N usuarios ven el mismo canal → 1 solo slot del proveedor
+- Soporte multi-cuenta del mismo proveedor con balanceo de slots
+- Catálogos personalizados por usuario (live, VOD, series)
+- Integración Jellyfin: biblioteca local como categorías KiraTV
+- EPG XMLTV con merge por tvg-id
+- Dashboard en tiempo real (WebSocket): qué usuario ve qué canal y qué slot usa
+- Reconexión automática con detección de stall y A/V sync garantizado
+
+## Instalación
+
+```bash
+cp .env.example /opt/kirastream/.env
+# Editar .env con tus valores reales
+
+cd /opt/kirastream/frontend
+npm install && npm run build
+
+cd /opt/kirastream
+python3 -m venv venv
+venv/bin/pip install -r backend/requirements.txt
+venv/bin/python -m alembic upgrade head
+```
+
+## Configuración
+
+Ver `.env.example` para todas las variables disponibles.
+
+La configuración de Nginx está en `nginx/kirastream.conf`.  
+El servicio systemd está en `kirastream.service`.