# Setup: STT APIs - Gentle

## First time setup

To use autoEdit with Gentle, an open source offline speech to text service, you need to download a separate app to run alongside autoEdit2 on your mac. The first time you launch Gentle 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). This is 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 buggy in the alignment of the transcription, but is compatible with earlier versions of Mac Os X. Download this only if you don't have OS X Sierra or later, and don't intend to upgrade your OS any time soon.
* 2.Start the Gentle app by double clicking 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://1700174791-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 Gentle app
* 5.the Gentle server is now up and running.

From now on, you just need to launch Gentle and check local host is working.

## Launching Gentle’s local server

If you've 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://1700174791-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://1700174791-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/transcribing) to continue.

\_\_

{% hint style="info" %}
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.
{% endhint %}

{% hint style="info" %}
[autoEdit.io](http://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...
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://autoedit.gitbook.io/user-manual/setup-stt-apis/setup-stt-apis-gentle.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.