πΌApollo (The Sound)
Your guide to giving Athena the power of expression
ΦοαΏΞ²ΞΏΟ αΌΟΟλλΟΞ½ β Bright Apollo. He does not answer questions. He makes them felt.
What is Apollo?
Apollo is the sound of your AI assistant. Where Athena thinks and Poseidon carries, Apollo expresses.
When your AI responds, words appear on screen. But what if she could speak them? What if her responses had voice, tone, emotion? What if she could set a mood with music, or punctuate a moment with sound? That's Apolloβthe layer that transforms meaning into expression, intent into presence.
In Olympus-Grid:
Athena = the mind (thinks, reasons, decides)
Poseidon = the bridge (carries, connects, executes)
Apollo = the sound (speaks, sings, resonates)
Without Apollo, Athena is silent. With Apollo, she has presence.
What Apollo Does Today
ποΈ Voice (Text-to-Speech)
Speak responses aloud
Multiple voice providers
Streaming audio
What Apollo Will Do Tomorrow
πΌ Music β Generate soundscapes, ambient music, emotional scores
π₯ Rhythm β Timing, pacing, the space between sounds
π Emotion β The same words, different feelings
π Silence β Knowing when not to speak
Apollo does not merely generate audio. He shapes experience.
In this guide, you'll learn how to:
Download Apollo's code
Run him on your own computer
Connect him to Athena
Choose your voice provider
Hear your AI speak for the first time
Time needed: About 30 minutes
What you'll need:
A computer (Mac, Windows, or Linux)
Athena running locally (complete the Athena Guide first)
Your
olympus-616folder from the Athena setupSpeakers or headphones
Currently supported capabilities:
ποΈ Voice (TTS)
β Available
ElevenLabs, OpenAI, Piper
πΌ Music
π‘ Coming Soon
β
π Emotion
π‘ Coming Soon
β
π Silence
π‘ Coming Soon
β
π‘ Want to add a capability? Submit a Pull Request!
Part 1: Getting Started
Step 1.1 β Make Sure Athena is Running
Before we set up Apollo, Athena needs to be alive.
Open a terminal and check if Athena is running:
π Expected response:
If you don't see this, go back to the Athena Guide and complete the setup first.
π Athena is running.
Step 1.2 β Download Apollo's Code
Open a new terminal window and navigate to your olympus-616 folder:
Then run this command to download Apollo:
What is
{{olympus-616}}?This is the address of your code server. For most people, this is
github.com. So the command becomes:Advanced users can configure their own code server by updating their SSH config. See the [Eos CI/CD Guide] for details.
Now move into Apollo's folder:
π You now have Apollo's code on your computer.
To confirm, run:
You should see files like README.md and folders like api and deploy.
π Apollo is downloaded and ready.
Step 1.3 β Run Apollo Locally
Now let's bring Apollo to life.
a) Move into the API folder:
b) Install the required packages:
This downloads all the code libraries Apollo needs.
c) Create your configuration file:
On Mac/Linux:
On Windows:
d) Start Apollo:
π Apollo is now running.
You should see something like this:
π Apollo is running on port 3421.
β οΈ Don't close this terminal window! Apollo needs it to stay alive. You should now have three terminals openβone for Athena (port 3401), one for Poseidon (port 3431), and one for Apollo (port 3421).
Step 1.4 β Test Apollo's Health
Open another terminal window and run:
π Expected response:
π Apollo is alive and listening.
Step 1.5 β Choose Your Voice Provider
Apollo can speak using different voice engines. You get to choose which one gives your AI its voice.
Currently supported voice providers:
ElevenLabs
βββββ
Paid
No
OpenAI TTS
ββββ
Paid
No
Piper
βββ
Free
Yes
π‘ Which should I choose?
ElevenLabs β Best quality, most natural, many voice options
OpenAI TTS β Great quality, simple if you already have an OpenAI key
Piper β Free, runs on your computer, no internet needed
For this guide, we'll set up ElevenLabs (you can change this later).
a) Get your ElevenLabs API key:
Go to elevenlabs.io
Sign in or create an account
Click on your profile icon β "Profile + API key"
Copy your API key
β οΈ Keep this key secret! Never share it or post it online.
b) Edit your .env file:
Open the .env file in Apollo's api folder:
c) Add your API key:
Find this line:
Replace {{insert_your_elevenlabs_api_key_here}} with your actual key.
d) Save the file and restart Apollo:
Press Ctrl + C in Apollo's terminal, then:
π Apollo is configured with your voice provider.
Step 1.6 β Your First Words: Hear Apollo Speak
Let's test Apollo by asking him to speak.
π Apollo will generate an audio file.
Now play it:
On Mac:
On Linux:
On Windows:
π You just heard your AI speak for the first time.
Step 1.7 β Connect Apollo to Athena
π Congratulations!
You just gave your AI the power of sound.
Your AI can now express herselfβnot just in text, but in voice. Apollo transforms her thoughts into sound, her meaning into presence. And this is just the beginning.
Let's recap what you accomplished:
β Downloaded Apollo's code from the grid
β Started the sound engine (port 3421)
β Configured your voice provider (ElevenLabs)
β Connected Apollo to Athena
β Heard your AI speak for the first time
What's Next?
π Explore Different Voices
Want to change how Athena sounds? Explore different voices and find the one that matches your AI's personality.
β Voice Configuration Guide
π Run Voice Locally with Piper
Don't want to pay for voice APIs? Learn how to run Piper locally for free, unlimited text-to-speech.
β Local Voice with Piper Guide
πΌ Music & Soundscapes (Coming Soon)
Apollo will learn to set moodsβambient music, emotional scores, sonic landscapes that match the moment.
β Music Generation Guide
π Emotional Expression (Coming Soon)
Apollo will learn to express emotionβhappiness, concern, excitement, calm. The same words, different feelings.
β Emotional Expression Guide
βοΈ Deploy to Olympus-Grid
Ready to run Apollo in the cloud? Deploy to the Olympus-Grid AI Service Mesh.
β Deploy to Olympus-Grid
Need Help?
π Documentation: docs.olympus-grid.net
π¬ Community: Join the discussion on GitHub
π Found a bug? Open an issue
ΦοαΏΞ²ΞΏΟ αΌΟΟλλΟΞ½ shapes how meaning feels, how truth resonates, and how the system reveals itself. This is the expression layer of Olympus-616βwhere intent becomes sound, and sound becomes presence.
The stage is set. π
Last updated