# Setup: STT APIs - Gentle

## First time setup

To use autoEdit with Gentle, Open source offline speech to text service, you need to download a separate app to run along side on your mac. First time you launch this version of the app it will download the language model to work offline.

* 1.Download Gentle
  * [Gentle Version `0.10.1`](https://github.com/lowerquality/gentle/releases/tag/0.10.1). It's the recommended version as it is the latest and most stable. But it is not backward compatible with OS X versions preceding Sierra.
  * [Gentle version `0.9.1`](https://github.com/lowerquality/gentle/releases/tag/0.9.1) about`104mb`. It's bugging in the alignment of the transcription. But compatible with earlier version of Mac Os X. Download this only if you don't have OS X sierra and don't intend to upgrade your OS any time soon.
* 2.Start the Gentle app, double click on it.
* 3.Click`Enable full transcription`, this will download the language model component to be able to work offline.

![gentle\_enable\_full\_transcription](https://476305039-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LKETZisqiBNpYXfFMzt%2F-LKEUVC84akkW9lpSkbg%2F-LKEUVsd3sm4tnFsHqHE%2Fgentle_enable_full_transcription.png?generation=1534636986763509\&alt=media)

* 4.restart the app
* 5.the Gentle server is now up and running.

Future times, you just need to launch gentle anche check local host is working.

## Launching Gentle’s local server

If you already done the initial setup downloading the language model as described above, all you need to do when using gentle is click `open in browser`.

![gentle\_open\_in\_browser](https://476305039-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LKETZisqiBNpYXfFMzt%2F-LKEUVC84akkW9lpSkbg%2F-LKEUVsfR-4f0iE_wEDk%2Fgentle_open_in_browser.png?generation=1534636993237230\&alt=media)

This will open your default browser with this page, and this means the Gentle server is running locally. The address should be [http://localhost:8765](http://localhost/:8765]\(http/localhost:8765/).

![gentle\_browser](https://476305039-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LKETZisqiBNpYXfFMzt%2F-LKEUVC84akkW9lpSkbg%2F-LKEUVsh7_NgRTgNBn56%2Fgentle_browser.png?generation=1534636992733358\&alt=media)

Now you are ready to chose Gentle as an option when adding a new transcription. Go back to the [user manual](https://autoedit.gitbook.io/user-manual/master/transcribing) to continue.

Sign up to the [mailing list](http://eepurl.com/cMzwSX), follow on [twitter](http://twitter.com/autoEdit2) and/or [facebook](https://www.facebook.com/autoEdit.io/) to keep up to date with the latest releases. Say hi at [pietro@autoEdit.io](mailto:pietro@autoEdit.io?Subject=Hello), always curious to hear what autoEdit is helping you with.

[autoEdit.io](https://github.com/pietrop/autoEdit_2_user_manual/tree/d5c8cea5ec4e2a1cee11515e8a838d832407badc/setup-stt-apis/www.autoEdit.io) it's free and open source. Free as in free speech as well as in free beer. [Help support the autoEdit project to keep it that way](https://donorbox.org/c9762eef-0e08-468e-90cb-2d00643697f8?recurring=true). Support will go towards fixing bugs, adding features, provide support for users etc...
