🧄 aioli
Tu estudio de IA en casa: clona voces, compón canciones, dibuja imágenes,
genera vídeo y produce podcasts. Todo en tu máquina. Sin nube.
🎙️ Voz • 🎵 Música • 🖼️ Imagen • 🎬 Vídeo • 🎧 Master • 📻 Podcast
Qué hace (con ejemplos reales)
| Plugin | Produce | Ejemplo |
|---|---|---|
🎙️ voice |
Voz clonada o sintética en WAV (español nativo con chatterbox, borradores gratis en CPU con piper) | aioli voice "Hola mundo" --profile vega -o hola.wav |
🎵 music |
Canción completa (voz + instrumentos) a partir de un estilo y tu letra; canta en español | aioli music --preset reggae-consciente -l mi-letra.txt -o tema.mp3 |
🖼️ image |
Imagen desde texto, edición, inpainting o referencia de personaje (~9 s con FLUX-klein-4b) | aioli image "un ajo robot" |
🎬 video |
Clip MP4 con audio sincronizado desde texto o imagen | aioli video "un ajo robot bailando" --frames 81 -o ajo.mp4 |
📝 stt |
Transcripción local: audio (o vídeo) a texto y subtítulos .srt/.vtt con tiempos por palabra |
aioli stt entrevista.mp3 -o subs.srt |
🎧 master |
Acabado de audio con ffmpeg: mezcla, ducking, reducción de ruido, -16 LUFS |
aioli master loudnorm mezcla.wav -o final.wav |
📻 podcast |
Episodio MP3 + notas del programa a partir de un guion (voces + cama musical + pausas) | aioli podcast episode guion.md -o ./ep1 |
19 canciones, sus carátulas y varios clips se hicieron así, en local, con estos comandos. Sin cuentas ni suscripciones.
Cómo funciona
aioli installinspecciona tu máquina y te dice qué cabe en tu GPU.aioli models downloaddescarga pesos verificados (sha256, reanudables) en~/.local/share/aioli/models(o donde apunteAIOLI_MODELS_DIR).- Generas en local: ni un byte sale de tu máquina. Sin cuentas ni suscripciones (ningún modelo del catálogo pide cuenta de HuggingFace).
Instalación
Tres pasos (Linux, Mac y Windows):
# 1. uv, el instalador de Python de Astral (si no lo tienes ya)
curl -LsSf https://astral.sh/uv/install.sh | sh # Linux y Mac
# Windows (PowerShell): powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# 2. aioli
uv tool install aioli-cli
# 3. el asistente: mira tu equipo, te recomienda qué cabe y descarga solo lo que elijas
aioli install
Necesitas también ffmpeg (Linux: sudo apt install ffmpeg · Mac:
brew install ffmpeg · Windows: winget install ffmpeg). aioli doctor
te dice si falta algo y cómo arreglarlo. Para actualizar: aioli update.
Próximamente: instalador de un solo comando que hace los tres pasos (y ffmpeg, preguntando antes). Ya está en
install.shdel repo.
¿No eres técnico? Pídeselo a tu asistente de IA
Si usas Claude Code (u otro asistente que ejecuta comandos):
aioli agent install # le enseña a tu asistente a instalar y usar aioli
Y luego pídele, sin más: «instálame aioli para hacer canciones con mi letra».
El asistente mira tu equipo (aioli status --json), te propone qué instalar con
su tamaño y licencia, pregunta antes de descargar y nunca usa sudo.
Para otros asistentes, aioli agent guide imprime la misma guía.
Requisitos
| Qué | Mínimo | Recomendado |
|---|---|---|
| SO | Linux (Ubuntu 22.04+), Mac | Ubuntu 24.04 |
| GPU | ninguna (voz en CPU con piper) | NVIDIA 12–16 GB de VRAM |
| Disco | 15 GB (un plugin) | 100 GB (el conjunto completo ≈ 60 GB) |
| Cuenta | — | — (sin cuentas: espejos públicos verificados) |
aioli install detecta tu máquina (nivel patata/modesta/capaz/bicha,
sí, de patata a bestia) y solo descarga lo que cabe. Los pesos se verifican
con sha256 y se reanudan si se corta tu conexión.
Uso
Camino feliz: aioli install → aioli <plugin> "texto" → aioli doctor
(solo si algo falla). Las recetas por modelo están en docs/USAGE.md.
# imagen: texto → PNG (edición, inpainting y referencia disponibles)
aioli image "un faro en la niebla"
aioli image "un faro en la niebla" -m z-image-turbo -o faro.png
# música: estilo + tu letra → canción completa
aioli music "rumba alegre" -l mi-letra.txt -o tema.mp3
aioli music generate --preset reggae-consciente -l mi-letra.txt -o tema.mp3
# voz: crea un perfil, añade una muestra con su transcripción, genera
aioli voice profiles create vega --language es
aioli voice profiles add-sample vega ref.wav -t "transcripción exacta del audio"
aioli voice "Hola mundo" --profile vega --engine chatterbox -o hola.wav
# vídeo: texto o imagen → clip con audio
aioli video "un ajo robot bailando" --frames 81 -o ajo.mp4
# podcast: guion con [ROL], [MUSIC:] y [PAUSE:] → episodio + notas
aioli podcast episode guion.md -o ./ep1
# master: remata cualquier audio (mezcla, ducking, -16 LUFS…)
aioli master loudnorm mezcla.wav -o final.wav
aioli <plugin> --help detalla cada comando; aioli doctor diagnostica
los fallos.
Licencia
MIT. Los pesos de terceros llevan su propia licencia (algunos no comerciales
o con aceptación previa en HuggingFace); aioli models te avisa.
Metadata
Release files for aioli-cli 0.3.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aioli_cli-0.3.5.tar.gz | 393.2 kB | With provenance | Details for aioli_cli-0.3.5.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| aioli_cli-0.3.5-py3-none-any.whl | Python 3 | none | any | Details for aioli_cli-0.3.5-py3-none-any.whl |
Total release size: 853.5 kB
Release files / aioli_cli-0.3.5.tar.gz
| Download URL | aioli_cli-0.3.5.tar.gz |
|---|---|
| Size | 393.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
db11e38cb4238ff995c6bbcea73d53b8a781c3df46125f7aef6770b7649078d0
|
|
BLAKE2b-256 checksum How to use checksums |
66623dc4c551455dee106fbc5b04b89e202478bb5125abb471b72149ad7d6bca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.
Transparency logRelease files / aioli_cli-0.3.5-py3-none-any.whl
| Download URL | aioli_cli-0.3.5-py3-none-any.whl |
|---|---|
| Size | 460.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
37bd1c68a3b0a9955786dc6b3f5ece78592a4f05d64bed79f012a667b779d3b5
|
|
BLAKE2b-256 checksum How to use checksums |
768dc6d67504b6fe5a6e7cb9a704b7e337bfd481da68ff909234b408c9232182
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.
Transparency logSecurity for aioli-cli 0.3.5
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for aioli_cli-0.3.5.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.