The SEPIA Framework is an excellent choice for creating your own open-source voice assistant, whether you’re using Windows, Mac, Raspbian, or other Linux systems. This guide will walk you through the easy steps to install and set up SEPIA on your preferred platform.
Installation Process
Before diving into the installation, it is important to gather some necessary supplies. Here’s a quick checklist of what you need:
- Java JDK 11 installed
- Access to the command line (Terminal on Mac/Linux, Command Prompt on Windows)
- A computer or Raspberry Pi
Getting Started with SEPIA Installation
To get started with SEPIA, you can follow these steps:
- Choose the appropriate release package from the release page.
- If you are using Raspberry Pi, refer to the detailed guide.
- For the easiest setup, run the following commands:
wget https://sepia-framework.github.io/install/sepia-home-rpi.sh
bash sepia-home-rpi.sh
Manual Installation (Any Platform)
If you prefer not to use a script, you can install SEPIA manually by following these instructions:
- Ensure **Java JDK 11** is installed:
- For Debian Linux:
sudo apt-get install openjdk-11-jdk-headless - For other platforms, check the Eclipse Adoptium Project.
- For Debian Linux:
- Download the SEPIA-Home bundle contents from here.
- Unzip and place the bundle content in a preferred directory (e.g.,
~SEPIArecommended for Linux).
unzip SEPIA-Home.zip -d ~SEPIA
- For Windows:
setup.bat - For Mac/Linux:
bash setup.sh
Final Steps to Launch SEPIA
Once everything is set up, you’ll want to start your SEPIA servers:
- Use the following command to launch SEPIA:
- Windows:
run-sepia.bat - Linux/Mac:
bash run-sepia.sh
- Windows:
- To ensure your setup is working, verify with
test-cluster.bat/test-cluster.sh. - Check the console for possible error messages, and monitor the
sepia-*log.outfiles for additional debugging info. - Access the SEPIA web app at localhost:20721/app/index.html. Ensure that the hostname is correct (e.g.,
localhostor your server’s IP address).
Troubleshooting Steps
If you encounter issues during installation, here are some troubleshooting tips to guide you:
- Ensure that all package dependencies are satisfied, particularly Java JDK 11.
- If the server fails to start, check your console output for error messages.
- Verify that the ports specified during setup are not being used by other applications.
- If using local IPs and features are limited, consider setting exceptions in your web browser as per this guide.
- In case of SSL encryption issues, refer to the SSL setup documentation.
For more insights, updates, or to collaborate on AI development projects, stay connected with fxis.ai.
Next Steps
If everything is working correctly, you can proceed to create a new (non-admin) account using the SEPIA Control-HUB:
- Log in using your admin credentials (default ID is
admin@sepia.localhost). - Navigate to the User Management section and create your own account.
Creating a Secure Server
To utilize all features without restrictions, you should secure your server with SSL encryption. Two options are:
- Self-signed SSL with fallback for private networks.
- Using Let’s Encrypt for dynamic DNS solutions for access outside your network.
Explore more about creating an SSL secure server in the SEPIA Wiki.
At fxis.ai, we believe that such advancements are crucial for the future of AI, as they enable more comprehensive and effective solutions. Our team is continually exploring new methodologies to push the envelope in artificial intelligence, ensuring that our clients benefit from the latest technological innovations.

