audia.cli — Command-line interface

audia CLI – powered by Typer.

Commands

audia convert <pdf_path> [options] Convert one or more PDFs to audio audia research <query> [options] Search ArXiv and convert selected papers audia listen <query> Record voice query, search, convert audia serve Start the FastAPI web UI audia info Show current settings

audia.cli.app.convert(pdf_paths=typer.Argument, project=typer.Option, output_dir=typer.Option, voice=typer.Option, open_after=typer.Option)

[bold green]Convert PDF(s) to audio.[/bold green]

Extracts text, applies agentic cleaning, and synthesises speech. .. rubric:: Example

audia convert paper.pdf audia convert paper.pdf –project icons audia convert paper1.pdf paper2.pdf –output ~/my_audio

Parameters:
Return type:

None

audia.cli.app.research(query=typer.Argument, max_results=typer.Option, output_dir=typer.Option, auto_convert=typer.Option)

[bold green]Search ArXiv and optionally convert papers to audio.[/bold green]

Presents a numbered list of results and lets you pick which to convert. .. rubric:: Example

audia research “diffusion models image generation” –convert

Parameters:

  • query (str)

  • max_results (int)

  • output_dir (Path | None)

  • auto_convert (bool)

Return type:

None

audia.cli.app.listen(seconds=typer.Option, output_dir=typer.Option)

[bold green]Record a voice query, search ArXiv, and convert to audio.[/bold green]

Pipeline: record → transcribe → LLM extracts search query → confirm → research

Parameters:

  • seconds (int)

  • output_dir (Path | None)

Return type:

None

audia.cli.app.serve(host=typer.Option, port=typer.Option, reload=typer.Option, open_browser=typer.Option)

[bold green]Start the audia web UI.[/bold green]

Launches a FastAPI server. Open http://localhost:8000 in your browser.

Parameters:
Return type:

None

audia.cli.app.info()

Show current configuration.

Return type:

None