Setup Superlinked Server
Last updated
Was this helpful?
Last updated
Was this helpful?
The Superlinked server is designed to be used by end users who want to leverage the power of Superlinked in deployable projects. With a simple command, you can run a Superlinked-powered app instance that creates REST endpoints and connects to external Vector Databases. This makes it an ideal solution for those seeking an easy-to-deploy environment for their Superlinked projects.
Before you can use this environment, you need to have:
Python 3.11 or higher installed with pip and venv modules. You can download Python from .
A Python virtual environment created and activated in a dedicated project folder of your choice.
Install the superlinked-server library: pip install superlinked-server
Note: The following documentation uses Unix-based terminal commands. Compatibility with other operating systems has not been verified.
To start the application follow the steps below:
Create the Superlinked app folder: Create a directory to store your Superlinked configuration files by running mkdir superlinked_app. For a minimal working example, copy the into your newly created superlinked_app directory. For more advanced use cases, please read the next section below.
Start the Superlinked server: To start the server run the python -m superlinked.server command.
By default, this will start the server on port 8080 (configurable via the SERVER_PORT environment variable) and expose the API endpoints for use. You can verify the server is running by visiting http://localhost:8080/docs in your browser.
Once your server is running, you'll need to configure and integrate your application. There are two main aspects to focus on:
Click on either link above for detailed documentation on each aspect.
If you encounter any issues while using this environment, please open an issue in this repository and we will do our best to help you.
- Learn how to structure and customize your application
- Understand how to interact with your application through the REST API