Skip to main content
Vulpy Commerce is a self-hostable ecommerce product that ships with its own AI operator, Fox, inside the box. Fox is a Hermes agent container that boots your shop from a fresh install, runs it day to day, and grows with you through a guided missions system. Under the hood you get a Medusa v2 backend, a Next.js storefront with Payload CMS, and self-hosted Matomo analytics on live.
These docs exist, but Fox knows the ins and outs. Every page here is a reference. The fastest way to get anything done is to open the Vulpy WebUI and ask Fox. Fox reads the same repo, runs the same commands, and can point you at (or fix) whatever you need.Try prompts like:
  • “Add a new product and put it in the summer category.”
  • “Why is the storefront returning a 500 on /checkout?”
  • “Take me through going live on my domain.”

​
Explore the docs

Quickstart

Clone the repo and get Fox and the storefront running locally in about ten minutes.

Architecture

Fox, the storefront, Medusa, and Matomo: how the pieces fit together.

Meet Fox

What the built-in AI operator is, what it does, and where you approve its actions.

Deploy to a VPS

The one-liner install for Ubuntu 24.04 with Docker, Caddy, and Tailscale.

​
From zero to a live shop

1

Install locally

Run pnpm bootstrap to set up env files, install dependencies, start Postgres, migrate, seed, and create an admin user.
2

Start Fox

pnpm db:hermes:up brings up the Fox container. Open the Vulpy WebUI at http://localhost:8787.
3

Run onboarding missions

Complete the guided welcome flow. Fox brings up the storefront and Medusa, runs migrations, seeds the catalog, and verifies the shop is healthy.
4

Go live

On a VPS, add a live environment with pnpm vulpy env add live, then pnpm vulpy env golive live when Matomo is up and the preview host is ready to 301 to your apex.
This is the Pro edition of Vulpy Commerce. Core (free) ships the same store plus Fox; Pro adds Payload product and category editorial, server install, and B2B or quote workflows. See editions.