<div align="center">
<img src="docs/source/_static/logo_banner.png" alt="autrainer — A Modular and Extensible Deep Learning Toolkit for Computer Audition Tasks">
</div>
# autrainer
[![autrainer PyPI Version](https://img.shields.io/pypi/v/autrainer?logo=pypi&logoColor=b4befe&color=b4befe)](https://pypi.org/project/autrainer/)
[![autrainer Python Versions](https://img.shields.io/pypi/pyversions/autrainer?logo=python&logoColor=b4befe&color=b4befe)](https://pypi.org/project/autrainer/)
[![autrainer Hugging Face](https://img.shields.io/badge/Hugging_Face-autrainer-b4befe?logo=huggingface&logoColor=b4befe)](https://huggingface.co/autrainer)
[![autrainer GitHub License](https://img.shields.io/badge/license-MIT-b4befe?logo=c)](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/).
- `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": null,
"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/a9/99/bfbe50fac7290130597d000c81130e91bd7eb5603280d062e28351cb271b/autrainer-0.1.0.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n <img src=\"docs/source/_static/logo_banner.png\" alt=\"autrainer \u2014 A Modular and Extensible Deep Learning Toolkit for Computer Audition Tasks\">\n</div>\n\n# autrainer\n\n[![autrainer PyPI Version](https://img.shields.io/pypi/v/autrainer?logo=pypi&logoColor=b4befe&color=b4befe)](https://pypi.org/project/autrainer/)\n[![autrainer Python Versions](https://img.shields.io/pypi/pyversions/autrainer?logo=python&logoColor=b4befe&color=b4befe)](https://pypi.org/project/autrainer/)\n[![autrainer Hugging Face](https://img.shields.io/badge/Hugging_Face-autrainer-b4befe?logo=huggingface&logoColor=b4befe)](https://huggingface.co/autrainer)\n[![autrainer GitHub License](https://img.shields.io/badge/license-MIT-b4befe?logo=c)](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- `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.1.0",
"project_urls": null,
"split_keywords": [
"computer audition",
" deep learning",
" artificial intelligence",
" pytorch",
" hydra-core",
" command-line",
" yaml"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a4bf183cc5e4115817be7db14976f9869a5108a6cc2d1430c80c1b2fc4a16342",
"md5": "c041c84d5f1a6091de211cf8f0e10c3c",
"sha256": "a01097ecb8a5f3cf267b16ed48a6ea1411f575cd6d095195b2b927f7a35d9f1c"
},
"downloads": -1,
"filename": "autrainer-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c041c84d5f1a6091de211cf8f0e10c3c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 243937,
"upload_time": "2024-09-16T11:34:11",
"upload_time_iso_8601": "2024-09-16T11:34:11.334337Z",
"url": "https://files.pythonhosted.org/packages/a4/bf/183cc5e4115817be7db14976f9869a5108a6cc2d1430c80c1b2fc4a16342/autrainer-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a999bfbe50fac7290130597d000c81130e91bd7eb5603280d062e28351cb271b",
"md5": "677ca33a974ea03512d4689194366176",
"sha256": "6be034b8650c5d3ff561c65db65a02cdc08b912e7a601197d9a9df4028f75f12"
},
"downloads": -1,
"filename": "autrainer-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "677ca33a974ea03512d4689194366176",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 112677,
"upload_time": "2024-09-16T11:34:13",
"upload_time_iso_8601": "2024-09-16T11:34:13.127086Z",
"url": "https://files.pythonhosted.org/packages/a9/99/bfbe50fac7290130597d000c81130e91bd7eb5603280d062e28351cb271b/autrainer-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-16 11:34:13",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "autrainer"
}