Metadata-Version: 2.4
Name: audel
Version: 0.1.0
Summary: Ears for AI Agents — a machine-graded audio feedback loop coding agents consume to self-correct before claiming done.
Project-URL: Homepage, https://github.com/amitpatole/audel
Project-URL: Repository, https://github.com/amitpatole/audel
Project-URL: Issues, https://github.com/amitpatole/audel/issues
Author-email: Amit Patole <amit.patole@gmail.com>
License: MIT
License-File: LICENSE
Keywords: agents,ai,asr,audio,llm,mcp,speech,voice
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.11
Requires-Dist: agentsensory>=0.1
Requires-Dist: filelock>=3.12
Requires-Dist: numpy>=1.26
Requires-Dist: platformdirs>=4.0
Requires-Dist: pydantic-settings>=2.2
Requires-Dist: pydantic>=2.6
Requires-Dist: typer>=0.12
Provides-Extra: all
Requires-Dist: anthropic>=0.40; extra == 'all'
Requires-Dist: fastapi>=0.110; extra == 'all'
Requires-Dist: faster-whisper>=1.0; extra == 'all'
Requires-Dist: google-genai>=0.3; extra == 'all'
Requires-Dist: httpx>=0.27; extra == 'all'
Requires-Dist: librosa>=0.10; extra == 'all'
Requires-Dist: mcp>=1.2; extra == 'all'
Requires-Dist: playwright>=1.44; extra == 'all'
Requires-Dist: python-multipart>=0.0.9; extra == 'all'
Requires-Dist: torch>=2.2; extra == 'all'
Requires-Dist: transformers>=4.40; extra == 'all'
Requires-Dist: uvicorn[standard]>=0.29; extra == 'all'
Provides-Extra: asr
Requires-Dist: faster-whisper>=1.0; extra == 'asr'
Provides-Extra: clap
Requires-Dist: librosa>=0.10; extra == 'clap'
Requires-Dist: torch>=2.2; extra == 'clap'
Requires-Dist: transformers>=4.40; extra == 'clap'
Provides-Extra: cloud
Requires-Dist: anthropic>=0.40; extra == 'cloud'
Requires-Dist: google-genai>=0.3; extra == 'cloud'
Requires-Dist: httpx>=0.27; extra == 'cloud'
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.5; extra == 'dev'
Provides-Extra: mcp
Requires-Dist: mcp>=1.2; extra == 'mcp'
Provides-Extra: render
Requires-Dist: playwright>=1.44; extra == 'render'
Provides-Extra: serve
Requires-Dist: fastapi>=0.110; extra == 'serve'
Requires-Dist: python-multipart>=0.0.9; extra == 'serve'
Requires-Dist: uvicorn[standard]>=0.29; extra == 'serve'
Description-Content-Type: text/markdown

# Audel — Ears for AI Agents 👂

> A machine-graded **audio** feedback loop that coding agents consume to self-correct
> before claiming *done*: **play → hear → report → fix.**

Sibling to **[AgentVision](https://github.com/amitpatole/agent-vision)** (eyes) and
**Verel** (brain). AgentVision confirms a video *renders*; **Audel confirms it actually
has sound and the narration is right.**

AI coding agents are **deaf** — they generate TTS, soundtracks, web-app sound effects,
voice-bot prompts, and audiobooks, and never *hear* the result. Audel gives them ears:
it grades audio/voice/media artifacts and returns a machine **verdict**
(`pass`/`warn`/`fail`) with **time-grounded** issues, so the agent self-corrects before
it claims done.

## Status

🚧 **Early development.** This `0.0.1` release reserves the name on PyPI. The graded API is
landing incrementally:

```python
import asyncio
from audel import analyze, load_settings   # coming soon

async def main():
    report = await analyze("dist/intro.mp4", settings=load_settings(audio_backend="local"))
    print(report.verdict, [i.message for i in report.issues])

asyncio.run(main())
```

Planned surface mirrors AgentVision one-to-one: async `analyze` / `check` / `watch` /
`render` / `compute_diff`, `Brief` / `IntentClaim`, `Report` / `Issue` (time-grounded via
`span`) / `Conformance` / `Handoff`, an `AudioBackend` protocol, and CLI / MCP / REST
adapters. Light base install (ffmpeg + DSP, no torch); ML behind extras
(`[render]`, `[asr]`, `[cloud]`, `[clap]`).

## Install

```bash
pip install audel
```

## License

MIT © Amit Patole
