# Using Piper

Navigate to [Piper](https://github.com/rhasspy/piper) and follow the setup instructions below to run Piper locally as a TTS backend.

### Setting Up Piper Locally

#### Method 1: Setup via Docker

1. Clone the artibex/piper repository:

   ```bash
   git clone git@github.com:artibex/piper-http.git
   ```
2. Navigate to the `piper-http` directory:

   ```bash
   cd piper-http
   ```
3. Add CORS support by installing Flask CORS in the Dockerfile. To do this, locate the Dockerfile and add the following line:

   ```bash
   RUN pip install flask_cors
   ```
4. Build the Piper Docker image:

   ```bash
   docker build -t http-piper .
   ```
5. Run the Piper Docker container:

   ```bash
   docker run --name piper -p 5000:5000 piper
   ```
6. To allow CORS within the Piper server, modify the `http_server.py` file inside the running Docker container:
   * Navigate to the `piper-http` container's files:

     ```bash
     docker exec -it piper /bin/bash
     ```
   * Locate the `http_server.py` file:

     ```bash
     cd /app/piper/src/python_run/piper
     ```
   * Edit `http_server.py` and add the following lines at the top to enable CORS:

     ```python
     from flask_cors import CORS
     CORS(app)
     ```
7. Save the changes and restart the Piper server inside the container:

   ```bash
   python3 http_server.py
   ```

#### Method 2: Manual Setup

1. Clone the repository:

   ```bash
   git clone https://github.com/flukexp/PiperTTS-API-Wrapper.git
   ```
2. Navigate to the project directory:

   ```bash
   cd PiperTTS-API-Wrapper
   ```
3. Download piper, install Piper sample voices and start piper server:

   ```bash
   ./piper_installer.sh
   ```

### Make sure Piper is enabled for TTS:

```bash
Settings -> Text-to-Speech -> TTS Backend -> Piper
```

#### Notes

* Piper can be used as a local text-to-speech backend in your application.
* For more details on models and configurations, refer to the official [Piper GitHub repository](https://github.com/rhasspy/piper).


---

# 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://docs.heyamica.com/connecting-speech-options-tts/using-piper.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.