# open-mercato/open-mercato

The AI-Engineering Foundation Framework for CRM/ERP and commerce: open-source TypeScript, with multi-tenancy, RBAC, events and domain modules already decided as conventions and specs, so Cursor, Claude Code and Codex build features instead of re-deciding architecture. Start with 80% done.

Repository: https://github.com/open-mercato/open-mercato
Canonical: https://ross.abutalabs.com/products/open-mercato
Homepage: https://www.openmercato.com/
Language: TypeScript
License: MIT
License Family: permissive
Topics: crm, typescript, admin-panel, ai-agents, ai-coding, framework, agentic, erp, nextjs, open-source, self-hosted
Last push: 2026-08-26T19:56:18+00:00

## Health v2 (maintenance only)
Score: 84/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 99, longevity 25
- inputs: {"age_days": 357, "days_push": 7, "days_rel": 7, "gap_med": 6.0, "n_releases_24m": 35}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1683, forks 375 (observed 2026-08-28T04:05:21.761125+00:00)

## What it is
Open Mercato is an open-source TypeScript foundation framework for building CRM, ERP, and commerce applications on Next.js, with multi-tenancy, RBAC, events, and domain modules pre-built as conventions and specs. It is designed to be 'AI-native', providing an architecture-aware harness so coding agents like Cursor, Claude Code, and Codex generate consistent, spec-compliant features.

## Use cases
- build a self-hosted CRM with custom workflows
- launch a B2B commerce or CPQ backend
- build an ERP with orders, catalog, and service modules
- expose typed APIs for mobile and web apps on a shared data model
- let AI coding agents generate features that follow team architecture conventions
- build internal business apps with multi-tenancy and RBAC out of the box

## When to choose
- you want a ready-made CRM/ERP/commerce foundation you can extend rather than build from scratch
- your team uses AI coding assistants and needs enforced architecture and specs for consistent output
- you need multi-tenancy, RBAC, audit, and encryption as built-in conventions
- you want full code ownership and self-hosting without per-seat SaaS pricing

## When to avoid
- you need a lightweight microservice or simple API without business-app scaffolding
- your stack is not TypeScript/Next.js/PostgreSQL
- you need a mature, battle-tested ERP with years of production hardening
- you prefer fully custom architecture decisions over opinionated conventions

## Facets
- artifact type: framework
- maturity: active
- function: web-framework, api-framework, auth, authorization, orm, search-engine, caching, mcp, agent-framework, workflow-automation, ui-components, cryptography
- domain: web-development, backend, erp, e-commerce, self-hosted, developer-tools, artificial-intelligence
- platform: self-hosted
- tags: crm, erp, multi-tenancy, rbac, ai-coding, agentic-development, modular-monolith, nextjs, mikroorm, admin-panel, commerce, spec-first, ai-agents, nodejs, typescript, web-server, docker

## Member repositories
- open-mercato/open-mercato (main) score 84

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:21.761125+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:41:19.869280+00:00, confidence not recorded.
  - readme: https://github.com/open-mercato/open-mercato (fetched 2026-08-28T04:05:21.761125+00:00, sha 5b229dd19c58)
  - homepage: https://www.openmercato.com/ (fetched 2026-08-29T11:14:34.041450+00:00, sha c2383ece5f69)
  - site_page: https://www.openmercato.com/about (fetched 2026-08-29T11:14:34.052504+00:00, sha 1e9d7adf20a2)
  - site_page: https://docs.openmercato.com/ (fetched 2026-08-29T11:14:34.054392+00:00, sha b48a2448cbb1)
  - site_page: https://www.openmercato.com/how-to-contribute (fetched 2026-08-29T11:14:34.050585+00:00, sha 9f84c3383056)
- Data as of 2026-08-30T08:39:29.467469+00:00.
