The SDK communicates with a Luna server instance using gRPC. Cobalt distributes a Docker image that contains the Luna server binary and model files.
Contact Cobalt to get a link to the image file in AWS S3. This link will expire in two weeks, so be sure to download the file to your own server.
Download with the AWS CLI if you have it, or with curl:
URL="the url sent by Cobalt"
IMAGE_NAME="name you want to give the file (should end with the same extension as the url, usually bz2)"
curl $URL -L -o $IMAGE_NAME
Load the docker image
docker load < $IMAGE_NAME
This will output the name of the image (e.g. luna-demo-en_us-16).
Start the Luna service
docker run -p 9001:9001 --name cobalt luna-demo-en_us-16
That will start listening for grpc commands on port 9001. You can replace
--name cobalt with any name you want to give the docker container.
The name simply provides a way to refer back to the running container.
The sdk-luna repo contains example code with subdirectories for various languages to build a demo client application.
The demo client creates a command-line interface that allows a user to submit text to Luna and receive back the synthesized audio. The client applications require a config file to specify the server information and an audio playback application. The playback application can be anything so long as it accepts formatted audio data from stdin. To run the application, do the following:
# After building via the `go build` command, run the CLI
cd /path/to/sdk-luna/examples/go
./luna-cli -config /path/to/config.toml
# After setting up an environment to use the Luna module, run the CLI
cd /path/to/sdk-luna/examples/python
python3 luna-cli.py -config /path/to/config.toml
# After building the example
cd /path/to/build/directory
./luna-cli -config /path/to/config.toml
Once the application is running, simply enter the text to synthesize at the prompt.