Whombat - Python Backend
whombat is an open-source web-based audio annotation tool designed to facilitate audio data labeling and annotation, with a special focus on aiding machine learning model development.
For additional details on installing the entire application and its usage, refer to the main README.
For the latest updates and detailed documentation, check out the official documentation.
Installation
With Pip
The most straightforward method to set up the backend and Whombat Python API is using pip. Execute the following command:
pip install whombat
From Source Code
Clone the repository:
git clone https://github.com/mbsantiago/whombat.git
Install the package:
cd whombat/backend
pip install .
With Docker
Run Whombat inside a Docker container. Build the container by cloning the repository and executing:
git clone https://github.com/mbsantiago/whombat.git
docker build -t whombat .
Once the build is complete, run the container with:
docker run -p 5000:5000 whombat
Development Environment
We manage Whombat's development with uv.
-
Follow the official installation instructions to get
uvon your machine. -
Clone the repository:
git clone https://github.com/mbsantiago/whombat.git
- Navigate to the backend directory and install dependencies:
cd whombat/back
uv sync
- Start the development server:
make serve-dev
or
WHOMBAT_DEV=true uv run python -m whombat
1 maintainer
Metadata
1 maintainer
Release files for Whombat 0.9.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| whombat-0.9.0.tar.gz | 7.5 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| whombat-0.9.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 15.7 MB
Release files / whombat-0.9.0.tar.gz
| Download URL | whombat-0.9.0.tar.gz |
|---|---|
| Size | 7.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dbb653fb94a7221134699dcb2a1ce5e28f63c1f86ae9ae7e34bd5adb214d7c79
|
|
BLAKE2b-256 checksum How to use checksums |
947c75360fe79710fc8497bc0ff43cbdcb2322ec9eb119bd14a4e26b8464e7f2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 May 13, 2026.
Transparency logRelease files / whombat-0.9.0-py3-none-any.whl
| Download URL | whombat-0.9.0-py3-none-any.whl |
|---|---|
| Size | 8.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2b97cbd297444f921a9a1db2a3c74a573f7b70b4fc002fd2aa59594cc4ef78f9
|
|
BLAKE2b-256 checksum How to use checksums |
b9b5d6c3c2cd640ebdecbbd6e59bc10a90dd81a8d551734a496a4fd44915ea86
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 May 13, 2026.
Transparency log
