graba-reunion 0.5.0__tar.gz

graba_reunion-0.5.0/.env.example

@@ -0,0 +1,35 @@
+# Obligatorios para grabar + diarizar
+HF_TOKEN=
+
+# Opcional: solo con --groq / --enrich-only
+GROQ_API_KEY=
+
+# PulseAudio / ALSA (obligatorios para grabar)
+GRABA_MIC=
+GRABA_MON=
+GRABA_AUDIO_BACKEND=pulse
+
+# Salida (default: $XDG_DATA_HOME/graba-reunion/recordings)
+GRABA_OUTPUT_DIR=
+GRABA_SESSION_PREFIX=reunion
+GRABA_DB=
+
+# Groq (minuta y título; requiere --groq)
+GRABA_GROQ_MODEL=llama-3.3-70b-versatile
+GRABA_GROQ_MAX_CHARS=120000
+GRABA_GROQ_TEMPERATURE=0.2
+
+# WhisperX (transcripción + diarización)
+# Defaults portables: cpu + int8. Con GPU: cuda + float16.
+GRABA_WHISPERX_MODEL=large-v3
+GRABA_WHISPERX_LANGUAGE=es
+GRABA_WHISPERX_DEVICE=cpu
+GRABA_WHISPERX_COMPUTE_TYPE=int8
+GRABA_WHISPERX_BATCH_SIZE=16
+
+# Alias opcionales (si no hay GRABA_WHISPERX_*)
+# GRABA_MODEL=large-v3
+# GRABA_LANGUAGE=es
+
+# Índice PyTorch CUDA (setup --install-deps)
+GRABA_TORCH_INDEX=https://download.pytorch.org/whl/cu124

graba_reunion-0.5.0/.gitignore

@@ -0,0 +1,22 @@
+reunion_*.txt
+*.txt
+!tests/fixtures/*.txt
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+dist/
+build/
+*.mp3
+*.srt
+!tests/fixtures/*.srt
+*.db
+*_minuta.md
+grabacion.txt
+.env
+.venv/
+venv/
+.coverage
+htmlcov/
+.pytest_cache/
+.ruff_cache/

graba_reunion-0.5.0/AGENTS.md

@@ -0,0 +1,81 @@
+# AGENTS.md
+
+Guía mínima para agentes que trabajan en este repositorio.
+
+## Stack
+
+- Python 3.10+, hatchling
+- CLI: argparse + subcomandos
+- Audio: ffmpeg + PulseAudio (ALSA opcional)
+- Transcripción: WhisperX (default) o faster-whisper (`--no-diarize`)
+- Minuta (opcional, `--groq`): Groq API (`llama-3.3-70b-versatile`)
+- Persistencia: SQLite (`reunions.db`)
+- Config: `$XDG_CONFIG_HOME/graba-reunion/.env` (override `GRABA_CONFIG`)
+- Salida default: `$XDG_DATA_HOME/graba-reunion/recordings`
+
+## Comandos importantes
+
+```bash
+make setup          # venv local + torch cu124
+make install        # pip install -e ".[dev]"
+make test           # pytest
+make lint           # ruff check
+make check          # lint + test
+bash scripts/pipx-install.sh   # instalación global con pipx
+graba-reunion setup
+graba-reunion check-deps
+graba-reunion list
+graba-reunion show 1
+```
+
+Detalle de setup, tokens HF y variables: ver [README.md](README.md) y la [guía completa](docs/guia-completa.md).
+
+## Estructura
+
+```text
+src/graba_reunion/
+  cli.py              # router argparse
+  config.py           # Settings + .env
+  paths.py            # rutas sesión y DB
+  recording.py        # ffmpeg
+  enrichment.py       # Groq + SQLite
+  groq_summary.py     # llamada Groq
+  db.py               # SQLite
+  setup_wizard.py     # wizard setup
+  deps_installer.py   # reparar torch CUDA
+  commands/           # list, show, setup, check-deps, record
+  transcription/      # whisperx, faster_whisper, srt
+scripts/              # setup.sh, pipx-install.sh
+tests/                # pytest + fixtures
+```
+
+## Convenciones
+
+- Código (nombres, funciones, logs técnicos): inglés
+- Comentarios y docs internas: español
+- Commits: Conventional Commits en inglés
+- Diff mínimo; no refactors masivos sin pedido
+- `show 1` / `list` rank 1 = reunión más reciente (`recorded_at DESC`)
+
+## Tests
+
+- Framework: pytest en `tests/`
+- Correr: `make test`
+- Mockear Groq, ffmpeg, whisperx y GPU; no requerir CUDA en tests
+- Fixtures en `tests/fixtures/`
+
+## Qué NO hacer
+
+- No depender de `../diarizacion`
+- No commitear `.env`, `.venv`, `*.mp3`, `reunion_*.txt`, `*.db`
+- No añadir secretos al repo
+- No instalar dependencias pesadas sin necesidad en el entorno del agente
+- No añadir CI sin que lo pidan
+- No borrar tests para hacer pasar la suite
+
+## Configuración
+
+- Secretos y audio: `~/.config/graba-reunion/.env` (plantilla `.env.example`); fallback de lectura al `.env` del repo
+- Wizard: `graba-reunion setup` (migra el `.env` del repo a XDG al escribir)
+- Defaults sin GPU: `device=cpu`, `compute_type=int8`
+- WhisperX viene en `dependencies`; torch CUDA: `graba-reunion setup --install-deps` o `scripts/pipx-install.sh`

graba_reunion-0.5.0/Makefile

@@ -0,0 +1,18 @@
+.PHONY: setup install test lint format check
+
+setup:
+	bash scripts/setup.sh
+
+install:
+	.venv/bin/pip install -e ".[dev]"
+
+test:
+	.venv/bin/pytest -q --cov=graba_reunion
+
+lint:
+	.venv/bin/ruff check src tests
+
+format:
+	.venv/bin/ruff format src tests
+
+check: lint test

graba_reunion-0.5.0/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.5
+Name: graba-reunion
+Version: 0.5.0
+Summary: Graba micrófono + monitor, transcribe con WhisperX y opcionalmente minuta con Groq
+Project-URL: Homepage, https://github.com/pablogventura/graba_reunion
+Project-URL: Repository, https://github.com/pablogventura/graba_reunion
+Project-URL: Documentation, https://github.com/pablogventura/graba_reunion/blob/main/docs/guia-completa.md
+Project-URL: Issues, https://github.com/pablogventura/graba_reunion/issues
+License-Expression: MIT
+Keywords: audio,diarization,ffmpeg,pulseaudio,recording,whisper
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Requires-Dist: faster-whisper>=1.0
+Requires-Dist: groq>=0.11
+Requires-Dist: whisperx>=3.8
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# graba-reunion
+
+Graba reuniones (micrófono + audio del monitor), transcribe con diarización ([WhisperX](https://github.com/m-bain/whisperX)) y, si querés (`--groq`), genera título + minuta con [Groq](https://groq.com/) en SQLite.
+
+**Documentación completa:** [docs/guia-completa.md](docs/guia-completa.md)
+
+## Inicio rápido
+
+```bash
+# Instalación (desde el clone)
+bash scripts/pipx-install.sh
+
+# Tokens, mic/monitor, device CPU/GPU
+graba-reunion setup
+graba-reunion check-deps
+
+# Grabar + transcribir (sin minuta)
+graba-reunion
+# Ctrl+C para detener y transcribir
+
+# Con minuta Groq + SQLite
+graba-reunion --groq
+```
+
+Salida por defecto: `~/.local/share/graba-reunion/recordings/`  
+Config: `~/.config/graba-reunion/.env`
+
+## Qué hace
+
+| Paso | Default | Opcional |
+|------|---------|----------|
+| Grabar mic + monitor (ffmpeg) | sí | `--skip-transcribe` solo audio |
+| Transcribir con speakers (WhisperX) | sí | `--no-diarize` (faster-whisper) |
+| Minuta + SQLite (Groq) | no | `--groq` / `--enrich-only` |
+
+## Requisitos
+
+- Linux + PulseAudio (o PipeWire-as-Pulse); ALSA opcional
+- `ffmpeg`
+- Python 3.10+ (pipx trae el venv)
+- [HF token](https://huggingface.co/settings/tokens) + aceptar licencias [pyannote diarization](https://huggingface.co/pyannote/speaker-diarization-community-1) y [segmentation](https://huggingface.co/pyannote/segmentation-3.0)
+- Groq API key solo si usás `--groq`
+- GPU NVIDIA recomendada; sin GPU: `device=cpu`
+
+## Comandos frecuentes
+
+```bash
+graba-reunion                      # grabar + transcribir
+graba-reunion -d .                 # grabar en el CWD
+graba-reunion --groq               # + minuta y DB
+graba-reunion --language en --model medium --device cpu
+graba-reunion --transcribe-only archivo.mp3
+graba-reunion --enrich-only archivo.txt
+graba-reunion list
+graba-reunion show 1               # 1 = más reciente
+graba-reunion show 1 --transcript
+graba-reunion setup
+graba-reunion setup --install-deps -y
+graba-reunion check-deps
+```
+
+## Configuración (resumen)
+
+| Ruta | Rol |
+|------|-----|
+| `~/.config/graba-reunion/.env` | Config preferida |
+| `GRABA_CONFIG` | Override de ruta |
+| `.env` en el clone | Fallback de lectura; se migra a XDG en el primer `setup` |
+| `~/.local/share/graba-reunion/recordings/` | Grabaciones por defecto |
+
+Plantilla de variables: [`.env.example`](.env.example).
+
+Variables clave:
+
+- `GRABA_MIC` / `GRABA_MON` / `GRABA_AUDIO_BACKEND`
+- `HF_TOKEN`, `GROQ_API_KEY` (opcional)
+- `GRABA_WHISPERX_MODEL`, `LANGUAGE`, `DEVICE` (default `cpu`), `COMPUTE_TYPE`
+- `GRABA_OUTPUT_DIR`, `GRABA_SESSION_PREFIX`, `GRABA_DB`
+
+Detalle de cada variable, flujos y troubleshooting: **[guía completa](docs/guia-completa.md)**.
+
+## Instalación (detalle breve)
+
+```bash
+# pipx (uso diario)
+bash scripts/pipx-install.sh
+
+# desarrollo
+make setup
+make check
+```
+
+Índice torch CUDA: `GRABA_TORCH_INDEX` (default cu124).
+
+## Desarrollo
+
+Ver [AGENTS.md](AGENTS.md).
+
+```bash
+make test
+make lint
+make check
+```
+
+## Troubleshooting rápido
+
+| Problema | Acción |
+|----------|--------|
+| `whisperx` no encontrado | `graba-reunion setup --install-deps` |
+| HF 401/403 | Aceptar pyannote + revisar `HF_TOKEN` |
+| Sin CUDA | `device=cpu` o `setup --install-deps -y` |
+| Sin audio | `pactl list sources short` (mic vs `.monitor`) |
+| ¿Dónde está el `.env`? | `graba-reunion check-deps` |
+
+Más casos: [guía completa - Troubleshooting](docs/guia-completa.md#17-troubleshooting).

graba_reunion-0.5.0/README.md

@@ -0,0 +1,115 @@
+# graba-reunion
+
+Graba reuniones (micrófono + audio del monitor), transcribe con diarización ([WhisperX](https://github.com/m-bain/whisperX)) y, si querés (`--groq`), genera título + minuta con [Groq](https://groq.com/) en SQLite.
+
+**Documentación completa:** [docs/guia-completa.md](docs/guia-completa.md)
+
+## Inicio rápido
+
+```bash
+# Instalación (desde el clone)
+bash scripts/pipx-install.sh
+
+# Tokens, mic/monitor, device CPU/GPU
+graba-reunion setup
+graba-reunion check-deps
+
+# Grabar + transcribir (sin minuta)
+graba-reunion
+# Ctrl+C para detener y transcribir
+
+# Con minuta Groq + SQLite
+graba-reunion --groq
+```
+
+Salida por defecto: `~/.local/share/graba-reunion/recordings/`  
+Config: `~/.config/graba-reunion/.env`
+
+## Qué hace
+
+| Paso | Default | Opcional |
+|------|---------|----------|
+| Grabar mic + monitor (ffmpeg) | sí | `--skip-transcribe` solo audio |
+| Transcribir con speakers (WhisperX) | sí | `--no-diarize` (faster-whisper) |
+| Minuta + SQLite (Groq) | no | `--groq` / `--enrich-only` |
+
+## Requisitos
+
+- Linux + PulseAudio (o PipeWire-as-Pulse); ALSA opcional
+- `ffmpeg`
+- Python 3.10+ (pipx trae el venv)
+- [HF token](https://huggingface.co/settings/tokens) + aceptar licencias [pyannote diarization](https://huggingface.co/pyannote/speaker-diarization-community-1) y [segmentation](https://huggingface.co/pyannote/segmentation-3.0)
+- Groq API key solo si usás `--groq`
+- GPU NVIDIA recomendada; sin GPU: `device=cpu`
+
+## Comandos frecuentes
+
+```bash
+graba-reunion                      # grabar + transcribir
+graba-reunion -d .                 # grabar en el CWD
+graba-reunion --groq               # + minuta y DB
+graba-reunion --language en --model medium --device cpu
+graba-reunion --transcribe-only archivo.mp3
+graba-reunion --enrich-only archivo.txt
+graba-reunion list
+graba-reunion show 1               # 1 = más reciente
+graba-reunion show 1 --transcript
+graba-reunion setup
+graba-reunion setup --install-deps -y
+graba-reunion check-deps
+```
+
+## Configuración (resumen)
+
+| Ruta | Rol |
+|------|-----|
+| `~/.config/graba-reunion/.env` | Config preferida |
+| `GRABA_CONFIG` | Override de ruta |
+| `.env` en el clone | Fallback de lectura; se migra a XDG en el primer `setup` |
+| `~/.local/share/graba-reunion/recordings/` | Grabaciones por defecto |
+
+Plantilla de variables: [`.env.example`](.env.example).
+
+Variables clave:
+
+- `GRABA_MIC` / `GRABA_MON` / `GRABA_AUDIO_BACKEND`
+- `HF_TOKEN`, `GROQ_API_KEY` (opcional)
+- `GRABA_WHISPERX_MODEL`, `LANGUAGE`, `DEVICE` (default `cpu`), `COMPUTE_TYPE`
+- `GRABA_OUTPUT_DIR`, `GRABA_SESSION_PREFIX`, `GRABA_DB`
+
+Detalle de cada variable, flujos y troubleshooting: **[guía completa](docs/guia-completa.md)**.
+
+## Instalación (detalle breve)
+
+```bash
+# pipx (uso diario)
+bash scripts/pipx-install.sh
+
+# desarrollo
+make setup
+make check
+```
+
+Índice torch CUDA: `GRABA_TORCH_INDEX` (default cu124).
+
+## Desarrollo
+
+Ver [AGENTS.md](AGENTS.md).
+
+```bash
+make test
+make lint
+make check
+```
+
+## Troubleshooting rápido
+
+| Problema | Acción |
+|----------|--------|
+| `whisperx` no encontrado | `graba-reunion setup --install-deps` |
+| HF 401/403 | Aceptar pyannote + revisar `HF_TOKEN` |
+| Sin CUDA | `device=cpu` o `setup --install-deps -y` |
+| Sin audio | `pactl list sources short` (mic vs `.monitor`) |
+| ¿Dónde está el `.env`? | `graba-reunion check-deps` |
+
+Más casos: [guía completa - Troubleshooting](docs/guia-completa.md#17-troubleshooting).