# MatrixHub

[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/matrixhub-ai/matrixhub)
[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/13641/badge)](https://www.bestpractices.dev/projects/13641)

**MatrixHub** is an open-source, self-hosted AI model registry engineered for large-scale enterprise inference. It serves as a drop-in private replacement for Hugging Face, purpose-built to accelerate **vLLM** and **SGLang** workloads.

For target users, use cases, and current capabilities, see the [Overview](https://matrixhub.ai/docs/overview/).

## 🌐 Live Demo

Try MatrixHub instantly at **[demo.matrixhub.ai](https://demo.matrixhub.ai/)** — no setup required.

Sign in with the public demo credentials:

| Username | Password |
| --- | --- |
| `admin` | `changeme` |

> The demo is for evaluation only and may be reset at any time.

## 🚀 Quick Start

Follow the [Getting Started guide](https://matrixhub.ai/docs/getting-started/) to deploy MatrixHub and cache your first model.

For Docker Compose and Helm commands, see [Installation](https://matrixhub.ai/docs/installation/).

For vLLM, SGLang, llm-d, Dynamo, and model distribution examples, see the [Integrations guide](https://matrixhub.ai/docs/integrations/).

## Contributing and Development

We welcome contributions. 

See [CONTRIBUTING.md](CONTRIBUTING.md) for issues, pull requests, reviews, DCO, and release note requirements.

See [Development Guide](docs/development.md) for local setup, testing, and generated code.

See [Technical Design Docs](docs/design/README.md) for architecture and feature designs.

## Community and Support

Join us in [GitHub Discussions](https://github.com/matrixhub-ai/matrixhub/discussions)
or the [CNCF Slack `#matrixhub`](https://cloud-native.slack.com/archives/C0A8UKWR8HG)
for questions, ideas, and support.

- [Documentation site](https://matrixhub.ai)
- [CNCF Landscape](https://landscape.cncf.io/?item=ai-native-infra--model-asset-and-registry--matrixhub)
- [Roadmap](ROADMAP.md)

## Security

Please report vulnerabilities according to [SECURITY.md](SECURITY.md).

## License

MatrixHub is licensed under the [Apache License 2.0](LICENSE).