Python Library & CLI

audioshake is the official Python library and CLI for the AudioShake API — typed clients with automatic retries, and an audioshake command for processing files, folders, and URLs from the terminal.

pip install audioshake

Authenticate with an API key exported as AUDIOSHAKE_API_KEY, or sign in from the terminal with audioshake login.

GitHub

Source, issues, and changelog.

PyPI

Releases and version history.

Library

One call uploads the file, creates the Task, waits for it, and downloads the outputs:

from audioshake import AudioShake

with AudioShake() as client:  # reads AUDIOSHAKE_API_KEY
    result = client.run("song.wav", ["vocals", "drums"], output_dir="stems/song")

print(result.task.cost)                # credits charged
print([str(f) for f in result.files])  # stems/song/vocals.wav, stems/song/drums.wav

Each step is also available on its own (client.assets.upload, client.tasks.create, client.tasks.wait, client.tasks.download), errors are typed, and AsyncAudioShake offers the same surface for asyncio. See the library reference.

CLI

audioshake run takes files, folders, and URLs, shows a live progress tree, and writes one folder per source:

audioshake run song.wav -m vocals,drums -o stems/
audioshake run https://example.com/talk.mp3 -m transcription --language en
audioshake run panel.wav -m multi_voice --num-speakers 3

audioshake models        # what your account can run, with cost and formats
audioshake tasks list    # recent tasks

Or run it without installing anything:

uvx audioshake run song.wav -m vocals,drums

Pass --json for machine-readable output in scripts. See the CLI reference.

Requires Python 3.10+. The library is pre-1.0: breaking changes are called out in the changelog and bump the minor version.

Getting started

Tutorials

Tools

Support

GitHub

PyPI

Library

CLI

GitHub

PyPI

​Library

​CLI

Library

CLI