{"id":31959522,"url":"https://github.com/huggingface/audio-transformers-course","last_synced_at":"2025-10-14T15:33:09.262Z","repository":{"id":174967412,"uuid":"607667587","full_name":"huggingface/audio-transformers-course","owner":"huggingface","description":"The Hugging Face Course on Transformers for Audio","archived":false,"fork":false,"pushed_at":"2025-08-21T14:18:11.000Z","size":4336,"stargazers_count":453,"open_issues_count":60,"forks_count":142,"subscribers_count":32,"default_branch":"main","last_synced_at":"2025-09-30T18:02:25.918Z","etag":null,"topics":["audio","deep-learning","hacktoberfest","transformers"],"latest_commit_sha":null,"homepage":"","language":"MDX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/huggingface.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-02-28T12:48:20.000Z","updated_at":"2025-09-27T11:19:14.000Z","dependencies_parsed_at":"2024-11-19T23:15:57.051Z","dependency_job_id":"4aa99279-956b-4d45-8953-4117754c1623","html_url":"https://github.com/huggingface/audio-transformers-course","commit_stats":null,"previous_names":["huggingface/audio-transformers-course"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/huggingface/audio-transformers-course","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huggingface%2Faudio-transformers-course","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huggingface%2Faudio-transformers-course/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huggingface%2Faudio-transformers-course/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huggingface%2Faudio-transformers-course/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/huggingface","download_url":"https://codeload.github.com/huggingface/audio-transformers-course/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huggingface%2Faudio-transformers-course/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279019320,"owners_count":26086711,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","deep-learning","hacktoberfest","transformers"],"created_at":"2025-10-14T15:32:14.217Z","updated_at":"2025-10-14T15:33:09.257Z","avatar_url":"https://github.com/huggingface.png","language":"MDX","funding_links":[],"categories":["MDX"],"sub_categories":[],"readme":"# The Audio Transformers Course\n\nThis repo contains the content that's used to create [Hugging Face's Audio Transformers Course](https://huggingface.co/learn/audio-course/). \nThe course teaches you about applying Transformers to various tasks in audio and speech processing.It's completely free and open-source!\n\n## 🌎 Languages and translations\n\n| Language                                                                      | Source                                                                             | Authors                                                                                                                                                                                                                                                                                                                                                  |\n|:------------------------------------------------------------------------------|:-----------------------------------------------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [Bengali](https://huggingface.co/learn/audio-course/bn/chapter0/introduction)                     | [`chapters/bn`](https://github.com/huggingface/audio-transformers-course/tree/main/chapters/bn)       |                                                                               |\n| [English](https://huggingface.co/learn/audio-course/chapter0/introduction)                        | [`chapters/en`](https://github.com/huggingface/audio-transformers-course/tree/main/chapters/en)       |                                                                               |\n| [Spanish](https://huggingface.co/learn/audio-course/es/chapter0/introduction)                     | [`chapters/es`](https://github.com/huggingface/audio-transformers-course/tree/main/chapters/es)       |                                                                               |\n| [French](https://huggingface.co/learn/audio-course/fr/chapter0/introduction)                      | [`chapters/fr`](https://github.com/huggingface/audio-transformers-course/tree/main/chapters/fr)       |                                                                               |\n| [Korean](https://huggingface.co/learn/audio-course/ko/chapter0/introduction)                      | [`chapters/ko`](https://github.com/huggingface/audio-transformers-course/tree/main/chapters/ko)       |                                                                               |\n| [Russian](https://huggingface.co/learn/audio-course/ru/chapter0/introduction)                     | [`chapters/ru`](https://github.com/huggingface/audio-transformers-course/tree/main/chapters/ru)       | [@artyomboyko](https://github.com/artyomboyko), [@Lightmourne](https://github.com/Lightmourne)                                                                              |\n| [Turkish](https://huggingface.co/learn/audio-course/tr/chapter0/introduction)                     | [`chapters/tr`](https://github.com/huggingface/audio-transformers-course/tree/main/chapters/tr)       |                                                                               |\n| [Chinese (simplified)](https://huggingface.co/learn/audio-course/zh-CN/chapter0/introduction)     | [`chapters/zh-CN`](https://github.com/huggingface/audio-transformers-course/tree/main/chapters/zh-CN) |                                                                               |\n\n### Translating the course into your language\n\nAs part of our mission to democratise machine learning, we'd love to have the course available in many more languages! \nPlease follow the steps below if you'd like to help translate the course into your language 🙏.\n\n**🗞️ Open an issue**\n\nTo get started, navigate to the [_Issues_](https://github.com/huggingface/audio-transformers-course/issues) page of \nthis repo and check if anyone else has opened an issue for your language. If not, open a new issue by selecting \nthe _Translation template_ from the _New issue_ button.\n\nOnce an issue is created, post a comment to indicate which chapters you'd like to work on and we'll add your name to the list.\n\n**🗣 Join our Discord**\n\nSince it can be difficult to discuss translation details quickly over GitHub issues, we have created dedicated channels \nfor each language on our Discord server. Join here 👉: [http://hf.co/join/discord](http://hf.co/join/discord)\n\n**🍴 Fork the repository**\n\nNext, you'll need to [fork this repo](https://docs.github.com/en/get-started/quickstart/fork-a-repo). You can do this \nby clicking on the **Fork** button on the top-right corner of this repo's page.\n\nOnce you've forked the repo, you'll want to get the files on your local machine for editing. You can do that by cloning the fork with Git as follows:\n\n```bash\ngit clone https://github.com/YOUR-USERNAME/audio-transformers-course\n```\n\n**📋 Copy-paste the English files with a new language code**\n\nThe course files are organised under a main directory:\n\n* [`chapters`](https://github.com/huggingface/audio-transformers-course/tree/main/chapters): all the text and code snippets associated with the course.\n\nYou'll only need to copy the files in the [`chapters/en`](https://github.com/huggingface/audio-transformers-course/tree/main/chapters/en) \ndirectory, so first navigate to your fork of the repo and run the following:\n\n```bash\ncd ~/path/to/audio-transformers-course\ncp -r chapters/en/CHAPTER-NUMBER chapters/LANG-ID/CHAPTER-NUMBER\n```\n\nHere, `CHAPTER-NUMBER` refers to the chapter you'd like to work on and `LANG-ID` should be ISO 639-1 (two lower case letters) \nlanguage code -- see [here](https://www.loc.gov/standards/iso639-2/php/code_list.php) for a handy table.\nAlternatively, {two lowercase letters}-{two uppercase letters} format is also supported, e.g. `zh-CN`, here's \nan [example](https://huggingface.co/learn/nlp-course/zh-CN/chapter1/1).\n\n**✍️ Start translating**\n\nNow comes the fun part - translating the text! The first thing we recommend is translating the part of the `_toctree.yml` file that corresponds to your chapter. This file is used to render the table of contents on the website and provide the links to the Colab notebooks. The only fields you should change are the `title`, ones -- for example, here are the parts of `_toctree.yml` that we'd translate for [Chapter 0 of the NLP course](https://huggingface.co/course/chapter0/1?fw=pt):\n\n```yaml\n- title: 0. Setup # Translate this!\n  sections:\n  - local: chapter0/1 # Do not change this!\n    title: Introduction # Translate this!\n```\n\n\u003e 🚨 Make sure the `_toctree.yml` file only contains the sections that have been translated! Otherwise you won't be able to build the content on the website or locally (see below how).\n\n\nOnce you have translated the `_toctree.yml` file, you can start translating the [MDX](https://mdxjs.com/) files associated with your chapter.\n\n\u003e 🙋 If the `_toctree.yml` file doesn't yet exist for your language, you can simply create one by copy-pasting from the English version and deleting the sections that aren't related to your chapter. Just make sure it exists in the `chapters/LANG-ID/` directory!\n\n**👷‍♂️ Build the course locally**\n\nOnce you're happy with your changes, you can preview how they'll look by first installing the [`doc-builder`](https://github.com/huggingface/doc-builder) tool that we use for building all documentation at Hugging Face:\n\n```shell\npython -m pip install hf-doc-builder\n```\n\n```shell\ndoc-builder preview audio-transformers-course ../audio-transformers-course/chapters/LANG-ID --not_python_module\n```\n\nThis will build and render the course on [http://localhost:3000/](http://localhost:3000/). Although the content looks much nicer on the Hugging Face website, this step will still allow you to check that everything is formatted correctly.\n\n**🚀 Submit a pull request**\n\nIf the translations look good locally, the final step is to prepare the content for a pull request. Here, the first think to check is that the files are formatted correctly. For that you can run:\n\n```\npip install -r requirements.txt\nmake style\n```\n\nOnce that's run, commit any changes, open a pull request, and wait for a review. Congratulations, you've now completed your first translation 🥳!\n\n\u003e 🚨 To build the course on the website, double-check your language code exists in `languages` field of the `build_documentation.yml` and `build_pr_documentation.yml` files in the `.github` folder. If not, just add them in their alphabetical order.\n\n## 📔 Jupyter notebooks\n\nThe Jupyter notebooks containing all the code from the course are hosted on the [`huggingface/notebooks`](https://github.com/huggingface/notebooks) repo. If you wish to generate them locally, first install the required dependencies:\n\n```bash\npython -m pip install -r requirements.txt\n```\n\nThen run the following script:\n\n```bash\npython utils/generate_notebooks.py --output_dir nbs\n```\n\nThis script extracts all the code snippets from the chapters and stores them as notebooks in the `nbs` folder (which is ignored by Git by default).\n\n## ✍️ Contributing a new chapter\n\n\u003e Note: we are not currently accepting community contributions for new chapters. These instructions are for the Hugging Face authors.\n\nAdding a new chapter to the course is quite simple:\n\n1. Create a new directory under `chapters/en/chapterX`, where `chapterX` is the chapter you'd like to add.\n2. Add numbered MDX files `sectionX.mdx` for each section. \n3. Update the `_toctree.yml` file to include your chapter sections -- this information will render the table of contents on the website. If your section involves both the PyTorch and TensorFlow APIs of `transformers`, make sure you include links to both Colabs in the `colab` field.\n\nIf you get stuck, check out one of the existing chapters -- this will often show you the expected syntax.\n\nOnce you are happy with the content, open a pull request and wait for a review. We recommend adding the first chapter draft as a single pull request -- the team will then provide feedback internally to iterate on the content 🤗!\n\n## 🙌 Acknowledgements\n\nThe structure of this repo and README are inspired by the wonderful [Advanced NLP with spaCy](https://github.com/ines/spacy-course) course.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuggingface%2Faudio-transformers-course","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhuggingface%2Faudio-transformers-course","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuggingface%2Faudio-transformers-course/lists"}