🧄 aioli
Local-first AI media suite. One CLI, many plugins — everything on your machine, no cloud required. 🌙
🎙️ Voice • 🎵 Music • 🖼️ Image • 🎬 Video • 🎧 Post • 🎙️📻 Podcast
✨ Quickstart
curl -LsSf aioli.es/install.sh | sh # 🧄 dummy-proof: equipo → consejo → modelos
# …o paso a paso:
uv tool install aioli-cli # 📦 un paquete; extras: aioli-cli[voice-qwen3,full]
aioli setup # 🧭 asesora según tu GPU y descarga pesos
aioli doctor # 🩺 preflight: CUDA, ffmpeg, models, VRAM
aioli models download image music # ⬇️ weights with resume + sha256 (HF_TOKEN for gated repos)
aioli voice generate "..." --profile vega # 🎙️ clone a voice
aioli music generate "rumba alegre" --backend yue2 # 🎵 compose a song
aioli podcast episode "la historia del café" --minutes 5 # 📻 full episode
Desde el repo (dev):
uv tool install -e .desde la raíz (un solo paquete editable con todo dentro). Extras:uv tool install -e ".[full]".
🗂️ Layout
aioli/
apps/aioli/src/aioli_cli/ # 🧄 CLI (Typer + registry + setup + models)
libs/contract/src/ # 📜 contrato: config, doctor, probe, advise, fetch
plugins/*/src/ # 🔌 un módulo por modalidad (mismo dist, entry points para terceros)
docs/catalog.md # 🗺️ inventory of everything (legacy + new)
assets/ # 🎨 logo + mascot variants
📚 Docs
| Doc | Para quién |
|---|---|
| docs/INSTALL.md | 🧑💻 instalar desde cero (requisitos, HF_TOKEN, problemas comunes) |
| docs/USAGE.md | 🎨 recetas validadas por plugin (comandos que funcionan) |
| docs/adr/ | 🧠 por qué se decidió cada cosa (4 ADRs) |
| docs/catalog.md | 🗺️ inventario vivo: portado vs legacy + deuda |
📜 Contract (every plugin obeys it)
- ▶️
aioli <plugin> generate ...— produce media - ⬇️
aioli <plugin> models download— fetch weights with checksum - 🩺
aioli doctor— preflight: CUDA, ffmpeg, models, VRAM - ⚙️ Config in
~/.config/aioli/config.toml, env overrides (AIOLI_MODELS_DIR, …) - 🚫 No absolute paths, no hardcoded GPUs, no cloud credentials required.
🗺️ Status
See docs/catalog.md for the living inventory: what's ported, what's legacy, and the tech debt. 🧾
1 maintainer
Release files for aioli-cli 0.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aioli_cli-0.1.3.tar.gz | 143.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aioli_cli-0.1.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 338.1 kB
Release files / aioli_cli-0.1.3.tar.gz
| Download URL | aioli_cli-0.1.3.tar.gz |
|---|---|
| Size | 143.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
486816ae44b96df90284d459b4f30b60986206374c20b70810cf19228d91031a
|
|
BLAKE2b-256 checksum How to use checksums |
6d258fb4b612230741becfdcdbc48b97c548013afe229d20a24b4090314d5968
|
| 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 Sep 16, 2026.
Transparency logRelease files / aioli_cli-0.1.3-py3-none-any.whl
| Download URL | aioli_cli-0.1.3-py3-none-any.whl |
|---|---|
| Size | 195.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5fff80bb565069ae26d6423f643b545f0cab8784c07f040bc4d94034b9b4a260
|
|
BLAKE2b-256 checksum How to use checksums |
8e76461d0fb1a6d60481983de62df8d96e5a724405da81ba8c34d2d435bc2fc0
|
| 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 Sep 16, 2026.
Transparency log
