{"id":17992921,"url":"https://github.com/guitarml/chameleon","last_synced_at":"2025-03-26T01:31:33.291Z","repository":{"id":43836056,"uuid":"351904189","full_name":"GuitarML/Chameleon","owner":"GuitarML","description":"Vintage guitar amp using neural networks.","archived":false,"fork":false,"pushed_at":"2023-01-05T14:57:09.000Z","size":1864,"stargazers_count":83,"open_issues_count":1,"forks_count":4,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-21T01:11:08.375Z","etag":null,"topics":["audio","guitar","juce-framework","machinelearning","neural-network"],"latest_commit_sha":null,"homepage":"https://guitarml.com/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GuitarML.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":["GuitarML"],"patreon":"GuitarML","custom":"https://www.paypal.com/donate?business=H22K2S7B7ACMJ\u0026no_recurring=0\u0026item_name=Support+GuitarML\u0026currency_code=USD"}},"created_at":"2021-03-26T20:28:37.000Z","updated_at":"2024-12-13T03:35:17.000Z","dependencies_parsed_at":"2023-02-04T06:31:44.478Z","dependency_job_id":null,"html_url":"https://github.com/GuitarML/Chameleon","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuitarML%2FChameleon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuitarML%2FChameleon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuitarML%2FChameleon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuitarML%2FChameleon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GuitarML","download_url":"https://codeload.github.com/GuitarML/Chameleon/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245571841,"owners_count":20637410,"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","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","guitar","juce-framework","machinelearning","neural-network"],"created_at":"2024-10-29T20:09:38.428Z","updated_at":"2025-03-26T01:31:32.948Z","avatar_url":"https://github.com/GuitarML.png","language":"C++","funding_links":["https://github.com/sponsors/GuitarML","https://patreon.com/GuitarML","https://www.paypal.com/donate?business=H22K2S7B7ACMJ\u0026no_recurring=0\u0026item_name=Support+GuitarML\u0026currency_code=USD"],"categories":[],"sub_categories":[],"readme":"# Chameleon\n\n[![CI](https://github.com/GuitarML/Chameleon/actions/workflows/cmake.yml/badge.svg)](https://github.com/GuitarML/Chameleon/actions/workflows/cmake.yml) [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-brightgreen.svg)](https://www.gnu.org/licenses/gpl-3.0) [![Downloads](https://img.shields.io/github/downloads/GuitarML/Chameleon/total)](https://somsubhra.github.io/github-release-stats/?username=GuitarML\u0026repository=Chameleon\u0026page=1\u0026per_page=30)\n\n![app](https://github.com/GuitarML/Chameleon/blob/main/resources/Chameleon.jpg)\n\nChameleon is a guitar plugin using neural networks to create three distinct sounds from a vintage style amp head. EQ and gain were added to \nallow further modification of the three core sounds, named Red (high gain), Gold (crunchy), and Green (crisp and clean). In the same\nway a real amp head is used with a cabinet and other effects, this plugin is intended to be used in the signal chain along with IR's (cab sim),\nreverb, and any number of guitar effects. \n\nChameleon's core sound comes from a neural net inference engine which allows the plugin to disguise itself as a high end\ntube amplifier. The engine uses a stateful LSTM model, which improves the sound quality of the previous stateless LSTM used in the SmartAmpPro. It\nalso improves CPU usage compared to the [SmartAmpPro](https://github.com/GuitarML/SmartAmpPro) and [SmartGuitarAmp](https://github.com/GuitarML/SmartGuitarAmp).\n\nCheck out sound demos on YouTube: [Heavy Demo](https://youtu.be/1oYiklGes6A),  [Funky Demo](https://youtu.be/kXecJX9kWpQ)\u003cbr\u003e\nCheck out the tech article on [Towards Data Science](https://towardsdatascience.com/neural-networks-for-real-time-audio-stateful-lstm-b534babeae5d)\n\nChameleon is part of the [2021 KVR Audio Developer Challenge](https://www.kvraudio.com/product/chameleon-by-guitarml)\n\n## Installing the plugin\n\n1. Download the appropriate plugin installer (Windows, Mac, Linux) from the [Releases](https://github.com/GuitarML/Chameleon/releases) page.\n2. Run the installer and follow the instructions. May need to reboot to allow your DAW to recognize the new plugin.\n\n## Info\nRe-creation of the LSTM inference model from [Real-Time Guitar Amplifier Emulation with Deep\nLearning](https://www.mdpi.com/2076-3417/10/3/766/htm)\n\nThe [Automated-GuitarAmpModelling](https://github.com/Alec-Wright/Automated-GuitarAmpModelling) project was used to train the .json models.\u003cbr\u003e\nGuitarML maintains a [fork](https://github.com/GuitarML/Automated-GuitarAmpModelling) with a few extra helpful features, including a Colab training script.\n\nThe plugin uses [RTNeural](https://github.com/jatinchowdhury18/RTNeural), which is a highly optimized neural net inference engine intended for audio applications. \n\n## Build Instructions\n\n### Build with Cmake\n\n```bash\n# Clone the repository\n$ git clone https://github.com/GuitarML/Chameleon.git\n$ cd Chameleon\n\n# initialize and set up submodules\n$ git submodule update --init --recursive\n\n# build with CMake\n$ cmake -Bbuild\n$ cmake --build build --config Release\n```\nThe binaries will be located in `Chameleon/build/Chameleon_artefacts/`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguitarml%2Fchameleon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguitarml%2Fchameleon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguitarml%2Fchameleon/lists"}