medusa README

The project's README from github.com/medusajs/medusa. As one markdown file: README.md.

Medusa logo

Medusa

Documentation | Website

Building blocks for digital commerce

Medusa uses an open-core licensing model. PRs welcome!

Follow @medusajs Discord Chat

Getting Started

The fastest way to get started is with Medusa Cloud. It provides a managed environment optimized for Medusa applications, with automated deployments, scaling, and maintenance. Get started on Medusa Cloud

To set up a Medusa application locally, visit the Documentation.

About Medusa

Medusa is a commerce platform with a built-in framework for customization that allows you to build custom commerce applications without reinventing core commerce logic. The framework and modules can be used to support advanced B2B or DTC commerce stores, marketplaces, distributor platforms, PoS systems, service businesses, or similar solutions that need foundational commerce primitives. Medusa's core commerce modules are open-source and freely available on npm. Enterprise Edition features are identified separately in the repository.

Learn more about Medusa’s architecture and commerce modules in the Docs.

Upgrades & Integrations

Follow the Release Notes to keep your Medusa project up-to-date.

Check out all available Medusa integrations.

Community & Contributions

The core team is available in GitHub Discussions, where you can create issues, share ideas, and discuss roadmap.

Our Contribution Guide describes how to contribute to the codebase and Docs.

Join our Discord server to meet and discuss with more than 14,000 other community members.

Other channels

License

Medusa uses an open-core model. The core is licensed under the MIT License. The RBAC-based Enterprise Edition materials identified in ENTERPRISE-LICENSE.md require a commercial agreement with MedusaJS, Inc.

medusa (medusajs/medusa)

e-commerce
Searching Database…

36.8K ·GitHub
What is this?Medusa is an open-source commerce platform with a built-in framework for building custom commerce applications like B2B/DTC stores, marketplaces, distributor platforms, or PoS systems, without rebuilding core commerce logic.
Is this a ready-made storefront or a framework I build on top of?It's a framework and set of composable commerce modules (products, orders, carts, etc.) that you build your own application or storefront on top of, rather than a finished out-of-the-box store.
How do I get a Medusa application running?The fastest route is Medusa Cloud, a managed hosting environment with automated deployments and scaling. To run it yourself locally, you follow the setup instructions in the Documentation.
Do I need Node.js to run Medusa?Yes, Medusa is a TypeScript/Node.js project and its core commerce modules are distributed as npm packages.
Is everything in this repo free to use?The core commerce modules are open-source under MIT, but Medusa uses an open-core model where RBAC-based Enterprise Edition features require a separate commercial agreement.
Who is Medusa aimed at?Developers and teams building custom commerce systems, including those building AI agent-driven commerce experiences, per the project's own description.
What kinds of businesses can be built with Medusa?The README mentions B2B or DTC commerce stores, marketplaces, distributor platforms, point-of-sale systems, and service businesses as examples of what can be built on Medusa's commerce primitives.
How do I keep a Medusa project updated?You follow the project's Release Notes to track updates and keep a Medusa application up-to-date, and check the integrations list for available third-party connections.
Why does the tagline mention 'agents'?Medusa markets itself as 'the world's most flexible commerce platform for agents and developers,' positioning it for both traditional developer-built storefronts and AI-agent-driven commerce use cases.
Creator
medusajs
Size
881 MB
Stars
36.8K
Age
6y
Commits · 90 Days