How to Install and Set Up SEPIA Framework

Mar 31, 2023 | Programming

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:

  1. Choose the appropriate release package from the release page.
  2. If you are using Raspberry Pi, refer to the detailed guide.
  3. For the easiest setup, run the following commands:
  4. 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.
  • Download the SEPIA-Home bundle contents from here.
  • Unzip and place the bundle content in a preferred directory (e.g., ~SEPIA recommended for Linux).
  • unzip SEPIA-Home.zip -d ~SEPIA
  • Run the setup script:
    • For Windows: setup.bat
    • For Mac/Linux: bash setup.sh
  • During setup, choose options to install Elasticsearch (option 4) and the SEPIA-Framework (option 1). Remember the passwords you create!

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
  • 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.out files for additional debugging info.
  • Access the SEPIA web app at localhost:20721/app/index.html. Ensure that the hostname is correct (e.g., localhost or 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:

  1. Log in using your admin credentials (default ID is admin@sepia.localhost).
  2. 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.

Stay Informed with the Newest F(x) Insights and Blogs

Tech News and Blog Highlights, Straight to Your Inbox