[](https://twitter.com/intent/follow?screen_name=ten_platform) [](https://github.com/rte-design/astra.ai/discussions/) [](https://github.com/rte-design/astra.ai/graphs/commit-activity) [](https://github.com/rte-design/ASTRA.ai/issues) [](https://github.com/rte-design/ASTRA.ai/pulls) [](https://github.com/rte-design/ASTRA.ai/blob/main/LICENSE) [](https://discord.gg/VnPftUzAMJ) [](https://GitHub.com/rte-design/astra.ai/watchers/?WT.mc_id=academic-105485-koreyst) [](https://GitHub.com/rte-design/astra.ai/network/?WT.mc_id=academic-105485-koreyst) [](https://GitHub.com/rte-design/astra.ai/stargazers/?WT.mc_id=academic-105485-koreyst) [Documentation](https://astra-9.gitbook.io/ten-platform)   •   [Getting Started](https://astra-9.gitbook.io/ten-platform/getting-started/quickstart)   •   [Tutorials](https://app.gitbook.com/o/we7IoLK5sA6RQzhItfkW/s/4KgjqM5ChU0dSGjTLZmG/~/changes/6/tutorials/how-to-build-extension-with-go)

Voice agent: Astra

How to build voice agent locally ### Prerequisites #### Keys - Agora App ID and App Certificate([read here on how](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web)) - Azure's [speech-to-text](https://azure.microsoft.com/en-us/products/ai-services/speech-to-text) and [text-to-speech](https://azure.microsoft.com/en-us/products/ai-services/text-to-speech) API keys - [OpenAI](https://openai.com/index/openai-api/) API key #### Installation - [Docker](https://www.docker.com/) / [Docker Compose](https://docs.docker.com/compose/) - [Node.js(LTS) v18](https://nodejs.org/en) #### Minimum system requirements - CPU >= 2 Core - RAM >= 4 GB #### Docker setting on Apple Silicon You will need to uncheck "Use Rosetta for x86_64/amd64 emulation on Apple Silicon" option for Docker if you are on Apple Silicon, otherwise the server is not going to work.  ### Next step #### 1. Modify config files In the root of the project, create these files from the examples. They will be used to store information for Docker Compose later. ```bash # Create .env from the example cp ./.env.example ./.env # Create property.json from the example cp ./agents/property.json.example ./agents/property.json ``` #### 2. Setup API keys Open the `.env` file and fill in the keys and regions. This is also where you can choose to use any different extensions: ``` # Agora App ID and Agora App Certificate # required: this variable must be set AGORA_APP_ID= AGORA_APP_CERTIFICATE= # Extension: agora_rtc # Azure STT key and region AZURE_STT_KEY= AZURE_STT_REGION= # Extension: azure_tts # Azure TTS key and region AZURE_TTS_KEY= AZURE_TTS_REGION= # Extension: openai_chatgpt # OpenAI API key OPENAI_API_KEY= ``` #### 3. Start agent development containers In the same directory, run the `docker` command to compose containers: ```bash # Execute docker compose up to start the services docker compose up ``` #### 4. Build agent and start server Open up a separate terminal window, build the agent and start the server: ```bash # Enter container to build agent docker exec -it astra_agents_dev bash make build # Once the build is done, run server on port 8080 make run-server ``` ### Finish and verify 🎉 #### Astra voice agent Open up localhost:3000 in browser to test Astra voice agent. #### Graph designer Open up another tab go to localhost:3001, and use graph designer to edit the flow and properties of any extensions. 

TEN Platform

Stay Tuned

Join Community

Code Contributors

Contribution Guidelines

License