aurclips 0.1.0__tar.gz

aurclips-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+.venv/
+.env
+data/
+logs/
+tools/
+credentials/
+__pycache__/
+*.pyc
+dist/
+*.egg-info/
+# Added by code-review-graph
+.code-review-graph/
+# tooling local de desarrollo (no se publica)
+.claude/
+.mcp.json
+.scratch/
+docs/agents/
+CLAUDE.md

aurclips-0.1.0/CONTEXT.md

@@ -0,0 +1,106 @@
+# aurclips
+
+Bot local que convierte grabaciones propias de gaming en Shorts de YouTube. El
+creador graba y opera la herramienta, así que el vocabulario está escrito desde
+ese punto de vista: el material es tuyo y las decisiones también.
+
+Los `_Avoid_` valen para la prosa en español —comentarios, mensajes, docs—, no
+para los identificadores, que van en inglés por convención del repo. Que el
+glosario diga *Marca* no hace incorrecto a `marks.anchors`.
+
+## Language
+
+### Material
+
+**Grabación**:
+El video largo del que salen los clips, ya sea dejado en el inbox o descargado
+de un canal. En el código y en la base es `video` (tabla `videos`).
+_Avoid_: fuente, input, video original
+
+**Beat**:
+Una unidad autocontenida de 20 a 45 segundos dentro de una grabación, con
+gancho, punto y cierre. Grabar en beats es la palanca que hace innecesario que
+el selector adivine.
+_Avoid_: bloque, momento, sección
+
+**Clip**:
+Un fragmento continuo de una grabación, elegido para publicarse como Short.
+_Avoid_: segmento, corte, highlight
+
+**Candidata**:
+Un tramo de la grabación que la heurística puntuó y que todavía no es un clip.
+_Avoid_: candidato, propuesta
+
+**Marca**:
+Un momento que el creador señaló mientras grababa, por voz o por archivo. Manda
+sobre cualquier puntuación.
+_Avoid_: señal, tag
+
+**Short**:
+Un clip que ya está en YouTube, publicado o programado.
+_Avoid_: publicación, video subido
+
+**Recorte suelto**:
+Un video vertical producido sin entrar al pipeline: sale del modo recortador,
+no existe en la base y por eso no tiene ni progreso ni criterio. No aparece en
+`status`, no espera revisión y no consume hueco de publicación. Es el mismo
+material que un **Clip** —misma selección, mismo render— pero sin el ciclo de
+vida que hace de un clip un **Short**.
+_Avoid_: exportación, corte rápido
+
+### Ciclo de vida
+
+El estado de un clip son dos cosas independientes que no hay que confundir.
+
+**Progreso**:
+Hasta dónde llegó algo por la parte mecánica del pipeline. Un clip está
+pendiente, renderizado, señalado, subido o fallido; una grabación está nueva,
+transcrita, con clips elegidos, terminada, omitida o fallida. En la base es
+`status`.
+_Avoid_: estado (a secas), fase, etapa
+
+**Criterio**:
+El veredicto del creador sobre un clip: sin revisar, aprobado o descartado. Es
+independiente del progreso — un clip puede estar renderizado y sin revisar, o
+renderizado y descartado. En la base es `approved`.
+_Avoid_: aprobación, validación, visto bueno
+
+**Revisión**:
+El momento en que el creador recorre los clips listos y aprueba, corrige o
+descarta cada uno. Es donde entra su criterio al pipeline.
+_Avoid_: moderación, QA, curación
+
+**Señalado**:
+Un clip que el filtro de contenido apartó por lo que dice, en vez de
+descartarlo. No confundir con **Marca**: señalado lo decide el filtro, marcado
+lo decides tú al grabar.
+_Avoid_: marcado (para este sentido), flagueado
+
+**Despublicar**:
+Devolver a la cola de revisión un clip cuyo Short borraste tú de YouTube. El
+sistema no borra nada del canal: registra que ya no está. Publicar no es el
+final del camino.
+_Cómo_: `State.clip_unpublished(clip_id)`, a propósito sin comando de CLI.
+_Avoid_: revertir, deshacer, retirar
+
+**Reencolar**:
+Devolver al pipeline lo que falló, tan atrás como haga falta según qué
+artefactos sobrevivieron. Es lo que hace el comando `retry`.
+_Avoid_: reintentar, reprocesar
+
+**Hueco de publicación**:
+La ranura del calendario que ocupa un Short. Se reparte uno por día, y un hueco
+ya consumido no se vuelve a ofrecer, ni siquiera al despublicar.
+_Avoid_: agenda, turno
+
+### Selección
+
+**Piso de calidad**:
+El valor por debajo del cual una candidata se descarta, medido como fracción de
+la mejor candidata de esa misma grabación. Decide *cuántos* clips salen.
+_Avoid_: mínimo, corte
+
+**Perfil**:
+El juego de pesos con que el selector puntúa, elegido según el género del canal.
+Decide *cuál* clip sale.
+_Avoid_: preset, modo, configuración

aurclips-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Felii
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aurclips-0.1.0/PKG-INFO

@@ -0,0 +1,257 @@
+Metadata-Version: 2.4
+Name: aurclips
+Version: 0.1.0
+Summary: De videos largos a YouTube Shorts verticales con subtítulos, 100% local
+Project-URL: Homepage, https://github.com/feliivk/aurclips
+Author: Felii
+License: MIT License
+        
+        Copyright (c) 2026 Felii
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: ffmpeg,local,shorts,subtitles,video,whisper,youtube
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Video
+Requires-Python: >=3.12
+Requires-Dist: faster-whisper>=1.1.0
+Requires-Dist: google-api-python-client>=2.140
+Requires-Dist: google-auth-oauthlib>=1.2
+Requires-Dist: opencv-python-headless>=4.9
+Requires-Dist: platformdirs>=4.0
+Requires-Dist: pydantic>=2.7
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: tzdata>=2024.1; sys_platform == 'win32'
+Requires-Dist: yt-dlp>=2025.1.1
+Provides-Extra: cuda
+Requires-Dist: nvidia-cublas-cu12; (sys_platform != 'darwin' and platform_machine == 'x86_64') and extra == 'cuda'
+Requires-Dist: nvidia-cudnn-cu12; (sys_platform != 'darwin' and platform_machine == 'x86_64') and extra == 'cuda'
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# 🎬 aurclips
+
+[![tests](https://github.com/feliivk/aurclips/actions/workflows/ci.yml/badge.svg)](https://github.com/feliivk/aurclips/actions/workflows/ci.yml)
+
+Convierte videos largos en Shorts verticales con subtítulos, **completamente
+local**. Corre en **Windows, Linux y macOS**.
+
+```bash
+aurclips clip mi_partida.mp4
+```
+
+```
+data/output/mi_partida/
+  0001_El_truco_que_nadie_conoce.mp4    ← 9:16, subtítulos quemados
+  0001_El_truco_que_nadie_conoce.txt    ← título, descripción y hashtags
+  0002_Por_que_nadie_termina_el_juego.mp4
+  0002_Por_que_nadie_termina_el_juego.txt
+```
+
+Sin API keys, sin cuenta, sin mandar tu material a ningún servidor: transcribir,
+elegir y editar pasa todo en tu máquina.
+
+## Qué hace
+
+- **Transcribe** con Whisper local, con tiempos por palabra (usa tu GPU NVIDIA
+  si la tienes).
+- **Elige los momentos**: lo que marcaste al grabar manda; si no marcaste,
+  puntúa estructura (gancho, preguntas, cierre de idea, densidad) y energía de
+  audio según tu género.
+- **Recorta a 9:16**, quita las pausas muertas (jump cuts) y encuadra en el
+  rostro si lo pides.
+- **Quema subtítulos** estilo viral, palabra a palabra.
+- **Escribe la metadata** de cada recorte en un `.txt` al lado: título,
+  descripción y hashtags, listos para copiar y pegar. Con
+  [Ollama](https://ollama.com) los redacta un modelo local; sin Ollama, una
+  heurística.
+
+## Qué NO hace
+
+- **No adivina bien sin tu ayuda.** Sin marcar nada al grabar, cuenta con **~1
+  recorte bueno por grabación**: el filtro de calidad prefiere quedarse corto
+  antes que rellenar. Marcar cambia eso por completo.
+- **No hay magia de IA en la selección.** Es una heurística simple y a propósito
+  ([ADR-0001](docs/adr/0001-extremos-apretados-centro-simple.md)): no modela
+  arcos narrativos ni persigue la viralidad. El criterio lo pones tú.
+- **No sube nada.** Publicar en YouTube existe, pero es opcional y viene
+  apagado.
+- **No acelera en GPU en macOS.** La GPU NVIDIA acelera la transcripción en
+  Windows y Linux; en macOS (incluido Apple Silicon) se transcribe en CPU. En
+  CPU funciona en todas partes, solo más lento.
+- **Está en beta.** Los defaults siguen en calibración: espera cambios de
+  configuración entre versiones y **mira lo que genera antes de publicarlo**.
+
+## Instalación
+
+Necesitas **[Python 3.12](https://www.python.org/downloads/)** y **ffmpeg**. La
+fuente de los subtítulos ya viene con el paquete.
+
+**ffmpeg** (una vez, con tu gestor de paquetes):
+
+| SO | Comando |
+| --- | --- |
+| macOS | `brew install ffmpeg` |
+| Debian/Ubuntu | `sudo apt install ffmpeg` |
+| Fedora | `sudo dnf install ffmpeg` |
+| Windows | `winget install ffmpeg` (o lo descarga `setup.ps1` a `tools\`) |
+
+**aurclips**:
+
+```bash
+# Linux / macOS
+git clone https://github.com/feliivk/aurclips && cd aurclips
+sh setup.sh
+```
+
+```powershell
+# Windows
+git clone https://github.com/feliivk/aurclips; cd aurclips
+powershell -ExecutionPolicy Bypass -File setup.ps1
+```
+
+Ambos crean un entorno virtual e instalan el comando `aurclips`. Si tienes GPU
+NVIDIA (Windows/Linux), el setup detecta `nvidia-smi` y ofrece el soporte CUDA;
+en CPU también funciona (baja `whisper.model` a `small`).
+
+¿Prefieres instalarlo como un paquete más, sin el script? Es un proyecto Python
+estándar:
+
+```bash
+pipx install git+https://github.com/feliivk/aurclips     # aislado, comando global
+# o, dentro de tu propio entorno:
+pip install git+https://github.com/feliivk/aurclips
+# con soporte GPU NVIDIA (Windows/Linux x86_64):
+pip install "aurclips[cuda] @ git+https://github.com/feliivk/aurclips"
+```
+
+Instalado así, aurclips guarda `config.yaml` y los datos en las carpetas de
+usuario de tu SO (las crea y te dice dónde en el primer arranque); corriendo
+desde el checkout usa `./config.yaml` y `./data`, como hasta ahora.
+
+Opcional pero recomendado — un modelo local que escriba los títulos:
+
+```bash
+ollama pull qwen2.5:7b
+```
+
+aurclips lo detecta solo. Sigue siendo local y gratis.
+
+> Los ejemplos usan el comando `aurclips` que crea el setup. Si prefieres no
+> activar el entorno, es equivalente a `.venv/bin/python -m aurclips` (Linux/mac)
+> o `.venv\Scripts\python -m aurclips` (Windows).
+
+## Ejemplo
+
+```bash
+aurclips clip "~/grabaciones/partida 12.mkv"
+aurclips clip partida.mp4 --out ~/edicion
+aurclips clip partida.mp4 --clips 1
+```
+
+`--out` cambia la carpeta de destino y `--clips` pone un tope solo para esa
+corrida. Nada de esto toca `config.yaml`, ni deja cola pendiente, ni necesita
+credenciales: un recorte suelto entra y sale.
+
+Recortar dos veces la misma grabación no la vuelve a transcribir — la
+transcripción queda en caché, así que probar parámetros es barato. La segunda
+corrida **reemplaza** los recortes de la primera en esa carpeta: si quieres
+conservar los anteriores, dales otro `--out`.
+
+Los mandos completos están en [Configuración](docs/config.md) y
+[Selección](docs/selection.md).
+
+## Luego: graba pensando en el recorte
+
+Cuando tú controlas la fuente, el problema deja de ser *"detectar buenos
+momentos en footage desconocido"* y pasa a ser *"grabar de forma que extraer sea
+fácil"*. Es la palanca más grande que tienes y no toca código:
+
+- **Graba en beats**: unidades de 20-45 s con gancho, punto y cierre.
+- **Marca en vivo**: di **"esto es un short"** mientras grabas y ese momento
+  gana sobre cualquier puntuación. El segmento con la frase se silencia, así que
+  marca el clip pero no entra en él. No hace falta decirla clavada (se compara
+  por parecido) ni marcar todos los videos.
+- **O por timestamps**: un `<video>.marks.txt` al lado de la grabación, que
+  puedes escribir con el hotkey de tu grabadora o con `aurclips mark`.
+
+Guía completa: [Grabar en beats](docs/grabar-en-beats.md).
+
+## Luego: que se publique solo
+
+Si los recortes ya te convencen, aurclips también lleva el ciclo completo: sube
+a YouTube en privado con fecha programada, y YouTube publica uno por día a la
+hora que fijes.
+
+```bash
+aurclips run       # ingesta -> recortes -> subida
+aurclips review    # aprobar o corregir antes de subir
+aurclips status    # qué hay en cola
+aurclips report    # métricas y qué está funcionando
+aurclips retry     # reencolar lo que falló
+```
+
+A diferencia del modo recortador, esto sí lleva una base de estado: cada clip
+tiene progreso (pendiente, renderizado, subido) y criterio tuyo (sin revisar,
+aprobado, descartado). Mientras `review.enabled` sea `true`, nada se sube sin
+pasar por tu criterio.
+
+Para dejarlo corriendo solo cada día, hay una receta por SO —cron/systemd en
+Linux, launchd en macOS, Programador de tareas en Windows— en
+[`packaging/`](packaging/README.md).
+
+Cómo dar de alta las credenciales, la cuota diaria, la programación y qué hacer
+si un Short salió mal: [Publicar en YouTube](docs/upload-youtube.md).
+
+Para vigilar canales y descargar material de YouTube en vez de usar tu propio
+inbox, mira `channels` en [Configuración](docs/config.md).
+
+## Documentación
+
+| | |
+| --- | --- |
+| [Cómo funciona](docs/pipeline.md) | El motor y los dos niveles, con el flujo de punta a punta |
+| [Grabar en beats](docs/grabar-en-beats.md) | Cómo grabar y marcar para que recortar sea trivial |
+| [Selección](docs/selection.md) | Cuántos clips salen y cuáles: piso de calidad y pesos |
+| [Configuración](docs/config.md) | Todas las claves de `config.yaml` |
+| [Publicar en YouTube](docs/upload-youtube.md) | Credenciales, cuota, programación, despublicar |
+| [CONTEXT.md](CONTEXT.md) | El vocabulario del proyecto |
+| [ADR](docs/adr/) | Decisiones de arquitectura y por qué |
+
+## Desarrollo
+
+```bash
+pip install -e .[dev]
+pytest
+```
+
+Los tests corren en segundos, sin GPU, sin video real y sin Ollama.
+
+## Licencia
+
+[MIT](LICENSE). El modelo de detección de rostros embebido
+([YuNet](https://github.com/opencv/opencv_zoo), int8) es también MIT.
+
+Eres responsable de tener derechos sobre el contenido que recortas y de cumplir
+los [términos de servicio de YouTube](https://www.youtube.com/t/terms) y las
+políticas de la YouTube Data API al usar la subida automática.

aurclips-0.1.0/README.md

@@ -0,0 +1,206 @@
+# 🎬 aurclips
+
+[![tests](https://github.com/feliivk/aurclips/actions/workflows/ci.yml/badge.svg)](https://github.com/feliivk/aurclips/actions/workflows/ci.yml)
+
+Convierte videos largos en Shorts verticales con subtítulos, **completamente
+local**. Corre en **Windows, Linux y macOS**.
+
+```bash
+aurclips clip mi_partida.mp4
+```
+
+```
+data/output/mi_partida/
+  0001_El_truco_que_nadie_conoce.mp4    ← 9:16, subtítulos quemados
+  0001_El_truco_que_nadie_conoce.txt    ← título, descripción y hashtags
+  0002_Por_que_nadie_termina_el_juego.mp4
+  0002_Por_que_nadie_termina_el_juego.txt
+```
+
+Sin API keys, sin cuenta, sin mandar tu material a ningún servidor: transcribir,
+elegir y editar pasa todo en tu máquina.
+
+## Qué hace
+
+- **Transcribe** con Whisper local, con tiempos por palabra (usa tu GPU NVIDIA
+  si la tienes).
+- **Elige los momentos**: lo que marcaste al grabar manda; si no marcaste,
+  puntúa estructura (gancho, preguntas, cierre de idea, densidad) y energía de
+  audio según tu género.
+- **Recorta a 9:16**, quita las pausas muertas (jump cuts) y encuadra en el
+  rostro si lo pides.
+- **Quema subtítulos** estilo viral, palabra a palabra.
+- **Escribe la metadata** de cada recorte en un `.txt` al lado: título,
+  descripción y hashtags, listos para copiar y pegar. Con
+  [Ollama](https://ollama.com) los redacta un modelo local; sin Ollama, una
+  heurística.
+
+## Qué NO hace
+
+- **No adivina bien sin tu ayuda.** Sin marcar nada al grabar, cuenta con **~1
+  recorte bueno por grabación**: el filtro de calidad prefiere quedarse corto
+  antes que rellenar. Marcar cambia eso por completo.
+- **No hay magia de IA en la selección.** Es una heurística simple y a propósito
+  ([ADR-0001](docs/adr/0001-extremos-apretados-centro-simple.md)): no modela
+  arcos narrativos ni persigue la viralidad. El criterio lo pones tú.
+- **No sube nada.** Publicar en YouTube existe, pero es opcional y viene
+  apagado.
+- **No acelera en GPU en macOS.** La GPU NVIDIA acelera la transcripción en
+  Windows y Linux; en macOS (incluido Apple Silicon) se transcribe en CPU. En
+  CPU funciona en todas partes, solo más lento.
+- **Está en beta.** Los defaults siguen en calibración: espera cambios de
+  configuración entre versiones y **mira lo que genera antes de publicarlo**.
+
+## Instalación
+
+Necesitas **[Python 3.12](https://www.python.org/downloads/)** y **ffmpeg**. La
+fuente de los subtítulos ya viene con el paquete.
+
+**ffmpeg** (una vez, con tu gestor de paquetes):
+
+| SO | Comando |
+| --- | --- |
+| macOS | `brew install ffmpeg` |
+| Debian/Ubuntu | `sudo apt install ffmpeg` |
+| Fedora | `sudo dnf install ffmpeg` |
+| Windows | `winget install ffmpeg` (o lo descarga `setup.ps1` a `tools\`) |
+
+**aurclips**:
+
+```bash
+# Linux / macOS
+git clone https://github.com/feliivk/aurclips && cd aurclips
+sh setup.sh
+```
+
+```powershell
+# Windows
+git clone https://github.com/feliivk/aurclips; cd aurclips
+powershell -ExecutionPolicy Bypass -File setup.ps1
+```
+
+Ambos crean un entorno virtual e instalan el comando `aurclips`. Si tienes GPU
+NVIDIA (Windows/Linux), el setup detecta `nvidia-smi` y ofrece el soporte CUDA;
+en CPU también funciona (baja `whisper.model` a `small`).
+
+¿Prefieres instalarlo como un paquete más, sin el script? Es un proyecto Python
+estándar:
+
+```bash
+pipx install git+https://github.com/feliivk/aurclips     # aislado, comando global
+# o, dentro de tu propio entorno:
+pip install git+https://github.com/feliivk/aurclips
+# con soporte GPU NVIDIA (Windows/Linux x86_64):
+pip install "aurclips[cuda] @ git+https://github.com/feliivk/aurclips"
+```
+
+Instalado así, aurclips guarda `config.yaml` y los datos en las carpetas de
+usuario de tu SO (las crea y te dice dónde en el primer arranque); corriendo
+desde el checkout usa `./config.yaml` y `./data`, como hasta ahora.
+
+Opcional pero recomendado — un modelo local que escriba los títulos:
+
+```bash
+ollama pull qwen2.5:7b
+```
+
+aurclips lo detecta solo. Sigue siendo local y gratis.
+
+> Los ejemplos usan el comando `aurclips` que crea el setup. Si prefieres no
+> activar el entorno, es equivalente a `.venv/bin/python -m aurclips` (Linux/mac)
+> o `.venv\Scripts\python -m aurclips` (Windows).
+
+## Ejemplo
+
+```bash
+aurclips clip "~/grabaciones/partida 12.mkv"
+aurclips clip partida.mp4 --out ~/edicion
+aurclips clip partida.mp4 --clips 1
+```
+
+`--out` cambia la carpeta de destino y `--clips` pone un tope solo para esa
+corrida. Nada de esto toca `config.yaml`, ni deja cola pendiente, ni necesita
+credenciales: un recorte suelto entra y sale.
+
+Recortar dos veces la misma grabación no la vuelve a transcribir — la
+transcripción queda en caché, así que probar parámetros es barato. La segunda
+corrida **reemplaza** los recortes de la primera en esa carpeta: si quieres
+conservar los anteriores, dales otro `--out`.
+
+Los mandos completos están en [Configuración](docs/config.md) y
+[Selección](docs/selection.md).
+
+## Luego: graba pensando en el recorte
+
+Cuando tú controlas la fuente, el problema deja de ser *"detectar buenos
+momentos en footage desconocido"* y pasa a ser *"grabar de forma que extraer sea
+fácil"*. Es la palanca más grande que tienes y no toca código:
+
+- **Graba en beats**: unidades de 20-45 s con gancho, punto y cierre.
+- **Marca en vivo**: di **"esto es un short"** mientras grabas y ese momento
+  gana sobre cualquier puntuación. El segmento con la frase se silencia, así que
+  marca el clip pero no entra en él. No hace falta decirla clavada (se compara
+  por parecido) ni marcar todos los videos.
+- **O por timestamps**: un `<video>.marks.txt` al lado de la grabación, que
+  puedes escribir con el hotkey de tu grabadora o con `aurclips mark`.
+
+Guía completa: [Grabar en beats](docs/grabar-en-beats.md).
+
+## Luego: que se publique solo
+
+Si los recortes ya te convencen, aurclips también lleva el ciclo completo: sube
+a YouTube en privado con fecha programada, y YouTube publica uno por día a la
+hora que fijes.
+
+```bash
+aurclips run       # ingesta -> recortes -> subida
+aurclips review    # aprobar o corregir antes de subir
+aurclips status    # qué hay en cola
+aurclips report    # métricas y qué está funcionando
+aurclips retry     # reencolar lo que falló
+```
+
+A diferencia del modo recortador, esto sí lleva una base de estado: cada clip
+tiene progreso (pendiente, renderizado, subido) y criterio tuyo (sin revisar,
+aprobado, descartado). Mientras `review.enabled` sea `true`, nada se sube sin
+pasar por tu criterio.
+
+Para dejarlo corriendo solo cada día, hay una receta por SO —cron/systemd en
+Linux, launchd en macOS, Programador de tareas en Windows— en
+[`packaging/`](packaging/README.md).
+
+Cómo dar de alta las credenciales, la cuota diaria, la programación y qué hacer
+si un Short salió mal: [Publicar en YouTube](docs/upload-youtube.md).
+
+Para vigilar canales y descargar material de YouTube en vez de usar tu propio
+inbox, mira `channels` en [Configuración](docs/config.md).
+
+## Documentación
+
+| | |
+| --- | --- |
+| [Cómo funciona](docs/pipeline.md) | El motor y los dos niveles, con el flujo de punta a punta |
+| [Grabar en beats](docs/grabar-en-beats.md) | Cómo grabar y marcar para que recortar sea trivial |
+| [Selección](docs/selection.md) | Cuántos clips salen y cuáles: piso de calidad y pesos |
+| [Configuración](docs/config.md) | Todas las claves de `config.yaml` |
+| [Publicar en YouTube](docs/upload-youtube.md) | Credenciales, cuota, programación, despublicar |
+| [CONTEXT.md](CONTEXT.md) | El vocabulario del proyecto |
+| [ADR](docs/adr/) | Decisiones de arquitectura y por qué |
+
+## Desarrollo
+
+```bash
+pip install -e .[dev]
+pytest
+```
+
+Los tests corren en segundos, sin GPU, sin video real y sin Ollama.
+
+## Licencia
+
+[MIT](LICENSE). El modelo de detección de rostros embebido
+([YuNet](https://github.com/opencv/opencv_zoo), int8) es también MIT.
+
+Eres responsable de tener derechos sobre el contenido que recortas y de cumplir
+los [términos de servicio de YouTube](https://www.youtube.com/t/terms) y las
+políticas de la YouTube Data API al usar la subida automática.

aurclips-0.1.0/aurclips/__init__.py

@@ -0,0 +1,3 @@
+"""Bot de automatización de Shorts: descarga, recorta, edita y publica."""
+
+__version__ = "0.1.0"