ecosystemai/ecosystem-recommender repository overview

⁠Ecosystem Recommender

A modern, Google search results-style product recommender that displays ML-powered recommendations with filtering, sorting, and AI explanations. Connects to the Ecosystem API⁠ for recommendations and user-interaction tracking.

⁠Quick Run

# Create network (first time only)
docker network create ecosystem

# Run with defaults (uses https://meruntime1.ecosystem.ai)
docker run -d \
  --name ecosystem-recommender \
  --network ecosystem \
  -p 54326:54326 \
  -e ECOSYSTEM_API_URL=https://meruntime1.ecosystem.ai \
  -e NUMBEROFFERS=10 \
  ecosystemai/ecosystem-recommender:latest

Then open http://localhost:54326⁠

⁠Configuration

Using a local Ecosystem API?

• Mac/Windows: ECOSYSTEM_API_URL=http://host.docker.internal:8091
• Same Docker network: ECOSYSTEM_API_URL=http://ecosystem-runtime:8091

⁠What You Need

1. Ecosystem API – A running Ecosystem API instance (hosted or self-hosted).
2. Network – For docker-compose: docker network create ecosystem
3. Optional – LLM_API_KEY for the AI Explain button (otherwise returns 503).

⁠Platforms

Check available tags for your architecture (linux/amd64, linux/arm64).

⁠Documentation

See the project README⁠ for Docker Compose, full environment reference, and troubleshooting.