graba-reunion

Graba reuniones (micrófono + audio del monitor), transcribe con diarización (WhisperX) y, si querés (--groq), genera título + minuta con Groq en SQLite.

Documentación completa: docs/guia-completa.md

Inicio rápido

# 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 + aceptar licencias pyannote diarization y segmentation
Groq API key solo si usás --groq
GPU NVIDIA recomendada; sin GPU: device=cpu

Comandos frecuentes

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.

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.

Instalación (detalle breve)

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

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.

Metadata

Release files for graba-reunion 0.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for graba-reunion 0.5.0
File	Size	Uploaded
graba_reunion-0.5.0.tar.gz	31.8 kB	Sep 21, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for graba-reunion 0.5.0
File	Interpreter	ABI	Platform	Reset
graba_reunion-0.5.0-py3-none-any.whl 27.3 kB Sep 21, 2026	Python 3	none	any	Details

Total release size: 59.1 kB

Release files / graba_reunion-0.5.0.tar.gz

Download URL	graba_reunion-0.5.0.tar.gz
Size	31.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`b786edec9bbecad8294d7dc9a4189c6dd0e21a6582415770207f89fc0fc97349`
BLAKE2b-256 checksum How to use checksums	`0c0e6bcb183516876be41a8f35143639ed6c04adcacc57d5e29b300d9dea947d`
Upload date	Sep 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / graba_reunion-0.5.0-py3-none-any.whl

Download URL	graba_reunion-0.5.0-py3-none-any.whl
Size	27.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7876441f799e8346fb0876ab997505da0950da131e39e37cea2f78d531014b32`
BLAKE2b-256 checksum How to use checksums	`1f3a832b4422ddfe10457d2c743abf6173eb9ed583aa62661f8dea066aafbe84`
Upload date	Sep 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release history Release notifications | RSS feed

This release

0.5.0 This release

Sep 21, 2026 2 release files

graba-reunion 0.5.0