Skip to Content
DocumentationCustomizationUsing the Suvereo Starter

Using the Suvereo Starter

Enthusiast is installed into a Suvereo deployment built from the suvereo-starter  repository. It contains Dockerfiles and configuration that build your own deployment of Suvereo, including your custom code and the packages you install from PyPI, such as Enthusiast. To set it up with Enthusiast, follow the installation guide.

This page describes where your own code and configuration go.

Repository Structure

server/ config/ .env <- Environment variables injected into the server. settings_override.py <- Your Suvereo configuration: domain definitions, agents, integrations. src/ pyproject.toml <- Describes your code as a Python package. Enthusiast packages are its dependencies. ... <- Your own agents, integrations and other code. Dockerfile <- Builds the server image with your code and its dependencies installed. frontend/ config/ .env <- Environment variables for the frontend.

The server image is built from server/src/ and server/config/settings_override.py. After changing either of them, rebuild the image and restart the containers:

docker compose build && docker compose up

Adding Your Own Code

Put your own agents, integrations and tools in the package in server/src/, next to the Enthusiast packages it depends on. Register them in server/config/settings_override.py the same way as the pre-built ones, using your package’s module path:

AVAILABLE_AGENTS = [ "enthusiast_agent_product_search.ProductSearchAgent", "my_package.agents.MyAgent", ]

To write your own e-commerce agents, see E-commerce Agents and Concept: Product Search Agent.

Last updated on