Stoa
Stoa is an open-source commerce engine for humans and agents. Built on Go for raw performance — ships with a Svelte storefront, admin panel, REST API, and native MCP support so AI agents can shop natively. Self-hosted. Extensible. Fast.
Stoa
A lightweight, open-source headless, agentic commerce platform built with Go. Ships as a single binary with the admin panel and storefront embedded.
Features
- Headless Architecture -- REST API (JSON)
- Single Binary -- Go backend with embedded SvelteKit frontends (Admin + Storefront)
- MCP Servers -- AI agents can shop in and manage the store via the Model Context Protocol
- Plugin System -- Extensible via hooks and custom API endpoints
- Multi-language -- Translation tables with locale-based API
- Property Groups & Variants -- Color, size, etc. with automatic combination generation
- Full-text Search -- PostgreSQL-based
- RBAC -- Role-based access control with granular API key permissions
Prerequisites
| Tool | Version | Purpose |
|---|---|---|
| Docker + Docker Compose | latest | Database (and optional app container) |
| Go | 1.23+ | Build backend (local development only) |
| Node.js | 20+ | Build frontends (local development only) |
| PostgreSQL | 16+ | Database (provided via Docker) |
Quick Start
git clone https://github.com/stoa-hq/stoa.git && cd stoa
cp config.example.yaml config.yaml
docker compose up -d
docker compose exec stoa ./stoa migrate up
docker compose exec stoa ./stoa admin create --email [email protected] --password your-password
| What | URL |
|---|---|
| Storefront | http://localhost:8080 |
| Admin Panel | http://localhost:8080/admin |
| API | http://localhost:8080/api/v1/health |
Documentation
Full documentation is available in the StoA Docs:
- Introduction -- what Stoa is and why it exists
- Quick Start -- get up and running in minutes
- Configuration -- all config options explained
- API Overview -- authentication, endpoints, and usage
- MCP Servers -- AI agent integration
- Plugin System -- extend Stoa without forking
- Payment Integration -- integrate any PSP
License
Apache 2.0 -- see LICENSE.
