Installation
Looking for the Enthusiast 1.7 installation guide? It is available here.
Enthusiast is the e-commerce domain definition for Suvereo. Suvereo provides the platform (conversations, agentic executions, language models, users and the admin UI), and Enthusiast is installed on top of it as a set of Python packages.
The quickest way to run Enthusiast is the Suvereo starter: a repository that starts Suvereo with Docker Compose and builds your own deployment, including the packages you add to it.
Setting Up the Starter
Clone the starter and create the configuration files from the samples:
git clone https://github.com/upsidelab/suvereo-starter
cd suvereo-starter
cp server/config/sample.env server/config/.env
cp frontend/config/sample.env frontend/config/.envThe default configuration uses the OpenAI API for generating embeddings and for the language model. Set your key in server/config/.env:
OPENAI_API_KEY=...Adding the Enthusiast Packages
Enthusiast is split into packages, so you can install only what you need:
| Package | Purpose |
|---|---|
enthusiast-domain | The domain definition itself: product and document entities, migrations, retrievers and sync managers. Always required. |
enthusiast-source-* | Product and document sources, and e-commerce store integrations. See Integrations. |
enthusiast-agent-* | Pre-built agents. See Pre-built Agents. |
Add them as dependencies of the starter’s server package in server/src/. To get started, install the domain definition together with the sample data source and the Product Search agent:
cd server/src
poetry add enthusiast-domain enthusiast-source-sample enthusiast-agent-product-searchThe packages are installed into the server image together with your own code.
Configuring Suvereo
Register the domain definition and its plugins in server/config/settings_override.py. The starter comes with a diet advice domain definition as an example: replace its entries with the Enthusiast ones, and keep the language model provider:
INSTALLED_DOMAIN_DEFINITIONS = ["enthusiast_domain"]
CATALOG_ENTITY_PLUGINS = [
"enthusiast_domain.models.Product",
"enthusiast_domain.models.Document",
]
CATALOG_INTEGRATION_MANAGERS = [
"enthusiast_domain.sync.ProductSourceManager",
"enthusiast_domain.sync.DocumentSourceManager",
"enthusiast_domain.sync.ECommerceIntegrationManager",
]
CATALOG_INTEGRATION_PLUGINS = [
"enthusiast_source_sample.SampleProductSource",
"enthusiast_source_sample.SampleDocumentSource",
]
CATALOG_LANGUAGE_MODEL_PROVIDERS = [
"suvereo_model_openai.OpenAILanguageModelProvider",
]
AVAILABLE_AGENTS = [
"enthusiast_agent_product_search.ProductSearchAgent",
]Each integration and agent page lists the exact entry to add when you install more of them.
Running It
Build and start the environment:
docker compose build && docker compose upThe domain definition ships its own database migrations. The server applies them when it starts.
When you add packages or change settings_override.py later, rebuild the image and restart the containers.
Accessing the Admin Panel
Once the containers are running, open the application at http://localhost:10001 . The API is at http://localhost:10000 .
Sign in as the initial admin user. By default:
Email: [email protected]
Password: changeme
To change these credentials and for other configuration options, see the Suvereo installation guide.
You can now import test data.