Skip to main content

Introduction

Marketlum is an open-source framework for building markets. It provides the foundational building blocks for modeling value creation, exchange, and governance between market participants.

What is Marketlum?​

Markets are complex systems where actors create, exchange, and consume value. Marketlum gives you a structured way to model these dynamics:

  • Actors are the participants — organizations, individuals, virtual actors, and AI agents — at the center of everything below
  • Values define what is produced, traded, and consumed (products, services, rights, relationships)
  • Exchanges capture the actual transactions between actors
  • Offerings package values into purchasable bundles
  • Agreements formalize the rules and terms between actors
  • Channels describe how participants reach each other
  • Value Streams group related values and activity into named flows
  • Tensions surface the gaps between current state and desired future

Humans and AI agents operate the market through Users — AI agents authenticate with API keys and can act as market actors — and everything they do lands in the audit trail.

Architecture​

Marketlum is a monorepo built with:

  • API — NestJS + TypeORM + PostgreSQL
  • Web — Next.js 16 (App Router) + shadcn/ui
  • Core — Shared business logic, entities, and services (@marketlum/core)
  • Shared — Zod schemas and TypeScript types (@marketlum/shared)
  • UI — Reusable React components and pages (@marketlum/ui)

Next Steps​