<div align="center">
  <img src="./marmot.svg" width="180">

# Marmot

**Discover any data asset in seconds. Then let your AI do the same.**

_The open-source context layer for your AI. Catalog your tables, topics, queues and APIs then expose real metadata to your AI agents._

[Documentation](https://marmotdata.io/docs/introduction) • [Live Demo](https://demo.marmotdata.io) • [Deploy](https://marmotdata.io/docs/Deploy) • [Community](https://discord.gg/TWCk7hVFN4)

</div>

## What is Marmot?

Marmot is an **open-source data catalog** for teams who want powerful data discovery without enterprise complexity. Catalog every data asset, enrich it with the context that matters and make it accessible to your team and your AI tools.

Unlike traditional catalogs that require extensive infrastructure and configuration, Marmot ships as a **single binary** with an intuitive UI, making it easy to deploy and start cataloging in minutes.

<div align="center">

<a href="https://www.youtube.com/watch?v=_JBcQGj_bFU">
  <img src="https://img.youtube.com/vi/_JBcQGj_bFU/maxresdefault.jpg" alt="Watch the Marmot demo on YouTube" width="480">
</a>

<p><a href="https://www.youtube.com/watch?v=_JBcQGj_bFU">▶ Watch the 2-minute demo</a></p>

</div>

## Features

- **Search everything**: Find any data asset in seconds with full-text search plus structured queries, boolean logic and metadata filters.
- **Interactive lineage**: Trace data flows from source to destination and analyse impact before making changes.
- **Metadata-first**: Store rich metadata for any asset type, from tables and topics to APIs and dashboards.
- **Team collaboration**: Assign ownership, document business context and maintain shared glossaries.
- **AI-ready**: Expose certified context through MCP, the API and the UI.

<div align="center">
  <img alt="Marmot context layer showing plugins, integrations and AI agents" src="./web/docs/static/img/graph.png" width="900">
</div>

## Deploy

**New to Marmot?** Follow the [Deploy](https://marmotdata.io/docs/Deploy) documentation for a guided setup, or try the [live demo](https://demo.marmotdata.io).

## Development

See [Local Development](https://marmotdata.io/docs/Develop/local-development) for how to get started developing locally.

## Community

Join our [Discord community](https://discord.gg/TWCk7hVFN4) for help, feedback and updates on new features.

## Contributing

All types of contributions are encouraged and valued!

- Report bugs or suggest features via [GitHub Issues](https://github.com/your-org/marmot/issues)
- Improve documentation
- Build new plugins for data sources

Before contributing, please check out the [Contributing Guide](CONTRIBUTING.md).



## FAQ

### What is Marmot?

Marmot is an **open-source data catalog** for teams who want powerful data discovery without enterprise complexity. It catalogs every data asset (tables, topics, queues, APIs), enriches it with context, and makes it accessible to both your team and AI tools. Unlike traditional catalogs requiring extensive infrastructure, Marmot ships as a **single binary** with an intuitive UI.

### Why Use Marmot?

| Feature | Benefit |
|---------|---------|
| **Search Everything** | Find any data asset in seconds with full-text search, structured queries, boolean logic, and metadata filters |
| **Interactive Lineage** | Trace data flows from source to destination, analyze impact before making changes |
| **Metadata-First** | Store rich metadata for any asset type (tables, topics, APIs, dashboards) |
| **Team Collaboration** | Assign ownership, document business context, maintain shared glossaries |
| **AI-Ready** | Expose certified context through MCP, API, and UI |
| **Single Binary** | No complex infrastructure required, deploy in minutes |

### How Does Marmot Integrate with AI Agents?

Marmot exposes certified context through **MCP (Model Context Protocol)**, enabling AI agents to query real metadata about your data assets. This allows AI tools to understand your data landscape, trace lineage, and make informed decisions based on actual metadata rather than guessing.

### What Data Sources Can I Catalog?

Marmot supports cataloging various data asset types through its plugin system:
- **Tables** (databases, data warehouses)
- **Topics** (message queues, event streams)
- **Queues** (job queues, messaging systems)
- **APIs** (REST, GraphQL, internal services)
- **Dashboards** (visualization tools, BI platforms)

### How Do I Deploy Marmot?

**Quick Start Options:**

| Method | Description |
|--------|-------------|
| **Documentation Guide** | Follow the [Deploy](https://marmotdata.io/docs/Deploy) guide for step-by-step setup |
| **Live Demo** | Try the [live demo](https://demo.marmotdata.io) before deploying |
| **Single Binary** | Download and run the single binary for your platform |

### Is Marmot Free?

Yes! Marmot is **open-source software** licensed under the **MIT License**. You can use, modify, and distribute it freely. Self-hosting is completely free with no licensing costs.

### How Can I Contribute?

All contributions are welcome:
- **Report bugs** or suggest features via [GitHub Issues](https://github.com/marmotdata/marmot/issues)
- **Improve documentation** (README, guides, API docs)
- **Build new plugins** for additional data sources
- **Check the [Contributing Guide](CONTRIBUTING.md)** before contributing

### Where Can I Get Help?

| Resource | Link |
|----------|------|
| **Documentation** | [marmotdata.io/docs](https://marmotdata.io/docs/introduction) |
| **Discord Community** | [Join Discord](https://discord.gg/TWCk7hVFN4) |
| **GitHub Issues** | [Report issues](https://github.com/marmotdata/marmot/issues) |
| **Live Demo** | [Try demo](https://demo.marmotdata.io) |

## License

Marmot is open-source software licensed under the [MIT License](LICENSE).
