Enthusiast
Add AI agents for product search and catalog enrichtment
Medusa Enthusiast Plugin
A Medusa plugin that integrates with Enthusiast. See the Enthusiast docs to learn more about the platform.
Prerequisites
- Access to a Suvereo instance running the Enthusiast domain definition (Enthusiast 2.x)
- The Medusa integration (Copy to clipboard
enthusiast-source-medusa) registered in the instance's Copy to clipboardCATALOG_INTEGRATION_PLUGINS - Medusa v2.x
- Node.js >= 20
Installation
Install the plugin in your Medusa project:
1npm install @upsidelab/medusa-plugin-enthusiast
Configuration
Environment Variables
Set you .env file in project root directory:
12345ENTHUSIAST_API_URL=http://localhost:10000ENTHUSIAST_WS_URL=ws://localhost:10000ENTHUSIAST_SERVICE_ACCOUNT_TOKEN=<generated-service-account-token>ENTHUSIAST_MEDUSA_BACKEND_URL=http://host.docker.internal:9000ENTHUSIAST_MEDUSA_ADMIN_URL=http://localhost:9000
- Copy to clipboard
ENTHUSIAST_API_URL: Your Enthusiast instance base API url. - Copy to clipboard
ENTHUSIAST_WS_URL: Your Enthusiast instance base WS url. The plugin opens WebSocket connections with Copy to clipboardENTHUSIAST_MEDUSA_ADMIN_URLas the Copy to clipboardOrigin, so that URL must be listed in the instance's Copy to clipboardECL_DJANGO_CORS_ALLOWED_ORIGINS. - Copy to clipboard
ENTHUSIAST_SERVICE_ACCOUNT_TOKEN: Your Enthusiast admin service account's token. - Copy to clipboard
ENTHUSIAST_MEDUSA_BACKEND_URL(Optional): Your medusa backend url, where Enthusiast can send request to (default is set to Copy to clipboardhttp://host.docker.internal:9000for local docker development or admin.backendUrl is set) - Copy to clipboard
ENTHUSIAST_MEDUSA_ADMIN_URL(Optional): Your medusa admin url (default is set to Copy to clipboardhttp://localhost:9000) - Copy to clipboard
ENTHUSIAST_INTEGRATION_TYPE(Optional): The type of the integration registered in your Enthusiast instance (Copy to clipboardCATALOG_INTEGRATION_PLUGINS) that Medusa data is synchronized through (default is Copy to clipboardmedusa). If you use the enthusiast-source-medusa plugin, leave this unset. If you have your own implementation, set it to the type your integration is registered with (see Copy to clipboardGET /api/integration-types/on your instance). - Copy to clipboard
ENTHUSIAST_OVERRIDE_EXISTING_INTEGRATION(Optional): The integration the plugin created itself is always reused. When Copy to clipboardtrue, and the dataset also has another integration of type Copy to clipboardENTHUSIAST_INTEGRATION_TYPEthat the plugin didn't create, that integration is adopted and its config overwritten. When Copy to clipboardfalse(default), a new integration is created instead and pre-existing ones are left untouched.
Enable plugin in Medusa
Add below entry to your plugins array:
medusa-config.ts
123456789101112{resolve: "@upsidelab/medusa-plugin-enthusiast",options: {enthusiastApiUrl: process.env.ENTHUSIAST_API_URL,enthusiastWSUrl: process.env.ENTHUSIAST_WS_URL,enthusiastServiceAccountToken: process.env.ENTHUSIAST_SERVICE_ACCOUNT_TOKEN,enthusiastIntegrationType: process.env.ENTHUSIAST_INTEGRATION_TYPE,overrideExistingIntegration: process.env.ENTHUSIAST_OVERRIDE_EXISTING_INTEGRATION === "true",medusaBackendUrl: process.env.ENTHUSIAST_MEDUSA_BACKEND_URL,medusaAdminUrl: process.env.ENTHUSIAST_MEDUSA_ADMIN_URL,}}
Run Database Migrations
After installing and configuring the plugin, run database migrations to create the required tables:
1npx medusa db:migrate
Generating service account key
Run command on your Enthusiast instance or go to Copy to clipboardManage -> Service accounts in Enthusiast to generate Admin permission service account token. Command:
1python manage.py createadminserviceaccount -n <name of your integration>
Usage
Once installed and configured, you can access the Enthusiast plugin in your Medusa Admin:
- Main Enthusiast Page: Navigate to the "Enthusiast" section in the admin sidebar
- Settings: Go to Settings -> Enthusiast to manage datasets and configurations
Version compatibility
Enthusiast version Plugin version 2.0 (docs) Copy to clipboard2.x (Copy to clipboard@upsidelab/medusa-plugin-enthusiast@^2.0.0) 1.7 (legacy docs) Copy to clipboard1.0.0 (Copy to clipboard@upsidelab/medusa-plugin-enthusiast@1.0.0)
The plugin versions are not interchangeable: 2.x talks to the Enthusiast 2.0 API, while 1.0.0 targets the Enthusiast 1.7 API.

