<div align="center">
<img src="https://autrainer.github.io/autrainer/_images/logo_banner.png" alt="autrainer — A Modular and Extensible Deep Learning Toolkit for Computer Audition Tasks">
</div>
# autrainer
[](https://pypi.org/project/autrainer/)
[](https://pypi.org/project/autrainer/)
[](https://huggingface.co/autrainer)
[](https://github.com/autrainer/autrainer/blob/main/LICENSE)
A Modular and Extensible Deep Learning Toolkit for Computer Audition Tasks.
_autrainer_ is built on top of [PyTorch](https://pytorch.org/) and [Hydra](https://hydra.cc/),
offering a modular and extensible way to perform reproducible deep learning experiments
for computer audition tasks using YAML configuration files and the command line.
## Installation
To install _autrainer_, first ensure that PyTorch (along with torchvision and torchaudio) version 2.0 or higher is installed.
For installation instructions, refer to the [PyTorch website](https://pytorch.org/get-started/locally/).
It is recommended to install _autrainer_ within a virtual environment.
To create a new virtual environment, refer to the [Python venv documentation](https://docs.python.org/3/library/venv.html).
Next, install _autrainer_ using _pip_.
```bash
pip install autrainer
```
The following optional dependencies can be installed to enable additional features:
- `latex` for LaTeX plotting (requires a LaTeX installation).
- `mlflow` for [MLflow](https://mlflow.org/) logging.
- `tensorboard` for [TensorBoard](https://www.tensorflow.org/tensorboard) logging.
- `opensmile` for audio feature extraction with [openSMILE](https://audeering.com/opensmile/).
- `albumentations` for image augmentations with [Albumentations](https://albumentations.ai/).
- `audiomentations` for audio augmentations with [audiomentations](https://github.com/iver56/audiomentations).
- `torch-audiomentations` for audio augmentations with [torch-audiomentations](https://github.com/asteroid-team/torch-audiomentations).
To install _autrainer_ with all optional dependencies, use the following command:
```bash
pip install autrainer[all]
```
To install _autrainer_ from source, refer to the [contribution guide](https://autrainer.github.io/autrainer/development/contributing.html).
## Next Steps
To get started using _autrainer_, the [quickstart guide](https://autrainer.github.io/autrainer/usage/quickstart.html) outlines the creation of a simple training configuration
and [tutorials](https://autrainer.github.io/autrainer/usage/tutorials.html) provide examples for implementing custom modules including their configurations.
For a complete list of available CLI commands, refer to the [CLI reference](https://autrainer.github.io/autrainer/usage/cli_reference.html) or the [CLI wrapper](https://autrainer.github.io/autrainer/usage/cli_wrapper.html).
Raw data
{
"_id": null,
"home_page": "https://github.com/autrainer/autrainer",
"name": "autrainer",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": "computer audition, deep learning, artificial intelligence, pytorch, hydra-core, command-line, yaml",
"author": "Simon Rampp",
"author_email": "simon.rampp@tum.de",
"download_url": "https://files.pythonhosted.org/packages/6c/7a/d6a937a8cbd27772ae347a2abfacb780efaa0777516e3dd9dfae381a064f/autrainer-0.7.1.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n <img src=\"https://autrainer.github.io/autrainer/_images/logo_banner.png\" alt=\"autrainer \u2014 A Modular and Extensible Deep Learning Toolkit for Computer Audition Tasks\">\n</div>\n\n# autrainer\n\n[](https://pypi.org/project/autrainer/)\n[](https://pypi.org/project/autrainer/)\n[](https://huggingface.co/autrainer)\n[](https://github.com/autrainer/autrainer/blob/main/LICENSE)\n\nA Modular and Extensible Deep Learning Toolkit for Computer Audition Tasks.\n\n_autrainer_ is built on top of [PyTorch](https://pytorch.org/) and [Hydra](https://hydra.cc/),\noffering a modular and extensible way to perform reproducible deep learning experiments\nfor computer audition tasks using YAML configuration files and the command line.\n\n## Installation\n\nTo install _autrainer_, first ensure that PyTorch (along with torchvision and torchaudio) version 2.0 or higher is installed.\nFor installation instructions, refer to the [PyTorch website](https://pytorch.org/get-started/locally/).\n\nIt is recommended to install _autrainer_ within a virtual environment.\nTo create a new virtual environment, refer to the [Python venv documentation](https://docs.python.org/3/library/venv.html).\n\nNext, install _autrainer_ using _pip_.\n\n```bash\npip install autrainer\n```\n\nThe following optional dependencies can be installed to enable additional features:\n\n- `latex` for LaTeX plotting (requires a LaTeX installation).\n- `mlflow` for [MLflow](https://mlflow.org/) logging.\n- `tensorboard` for [TensorBoard](https://www.tensorflow.org/tensorboard) logging.\n- `opensmile` for audio feature extraction with [openSMILE](https://audeering.com/opensmile/).\n- `albumentations` for image augmentations with [Albumentations](https://albumentations.ai/).\n- `audiomentations` for audio augmentations with [audiomentations](https://github.com/iver56/audiomentations).\n- `torch-audiomentations` for audio augmentations with [torch-audiomentations](https://github.com/asteroid-team/torch-audiomentations).\n\nTo install _autrainer_ with all optional dependencies, use the following command:\n\n```bash\npip install autrainer[all]\n```\n\nTo install _autrainer_ from source, refer to the [contribution guide](https://autrainer.github.io/autrainer/development/contributing.html).\n\n## Next Steps\n\nTo get started using _autrainer_, the [quickstart guide](https://autrainer.github.io/autrainer/usage/quickstart.html) outlines the creation of a simple training configuration\nand [tutorials](https://autrainer.github.io/autrainer/usage/tutorials.html) provide examples for implementing custom modules including their configurations.\n\nFor a complete list of available CLI commands, refer to the [CLI reference](https://autrainer.github.io/autrainer/usage/cli_reference.html) or the [CLI wrapper](https://autrainer.github.io/autrainer/usage/cli_wrapper.html).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Modular and Extensible Deep Learning Toolkit for Computer Audition Tasks.",
"version": "0.7.1",
"project_urls": {
"Documentation": "https://autrainer.github.io/autrainer/",
"Homepage": "https://github.com/autrainer/autrainer",
"Repository": "https://github.com/autrainer/autrainer"
},
"split_keywords": [
"computer audition",
" deep learning",
" artificial intelligence",
" pytorch",
" hydra-core",
" command-line",
" yaml"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "29e6a7700a3add340cbd251c7aa859224cc34efbe6fcd2b8695799011a61facf",
"md5": "4d8c159946b8f0571fe48b3c08906b86",
"sha256": "e14ae7ffef88e30aa13c201a988a9b9c96393b859f4157b0fd6fe4e82c72e6b0"
},
"downloads": -1,
"filename": "autrainer-0.7.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4d8c159946b8f0571fe48b3c08906b86",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 285746,
"upload_time": "2025-07-30T14:50:53",
"upload_time_iso_8601": "2025-07-30T14:50:53.673552Z",
"url": "https://files.pythonhosted.org/packages/29/e6/a7700a3add340cbd251c7aa859224cc34efbe6fcd2b8695799011a61facf/autrainer-0.7.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6c7ad6a937a8cbd27772ae347a2abfacb780efaa0777516e3dd9dfae381a064f",
"md5": "0e6ba52cc2526e7a1aa83cb52e0001a9",
"sha256": "16e04adc002316711f2372082da43f21f9771c77884d5ba7c798929c37bf8fad"
},
"downloads": -1,
"filename": "autrainer-0.7.1.tar.gz",
"has_sig": false,
"md5_digest": "0e6ba52cc2526e7a1aa83cb52e0001a9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 128076,
"upload_time": "2025-07-30T14:50:54",
"upload_time_iso_8601": "2025-07-30T14:50:54.799242Z",
"url": "https://files.pythonhosted.org/packages/6c/7a/d6a937a8cbd27772ae347a2abfacb780efaa0777516e3dd9dfae381a064f/autrainer-0.7.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-30 14:50:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "autrainer",
"github_project": "autrainer",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "autrainer"
}