---
id: music-assistant-models
version: "1.1.188"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# music-assistant-models — Music Assistant Base Models

License: permissive · Maintenance: active · Downloads: 255.9K/mo

## What it is and what it does

Music Assistant Models is a Python package that defines the shared data structures used by Music Assistant, a music streaming platform. It serves as a bridge between client and server components, ensuring consistent data representation across the system. The package relies on orjson for fast JSON serialization, mashumaro for efficient data marshalling, and unidecode for text normalization—all lightweight, focused dependencies that keep installation friction minimal.

This is a foundational library rather than a user-facing application. If you are building a Music Assistant client, integrating with a Music Assistant server, or developing plugins for the ecosystem, you will need these models to work with the platform's data types. The package is actively maintained (released 1 day ago) and supports current Python versions (3.11, 3.12, 3.13), making it a stable choice for integration work.

Use it for:

- Building a custom Music Assistant client that needs to deserialize and work with server responses.
- Developing Music Assistant plugins or extensions that exchange data with the core platform.
- Creating integrations between Music Assistant and other music services using shared model definitions.
- Testing Music Assistant server or client code that depends on consistent model schemas.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides shared data models for Music Assistant, a music streaming platform with client and server components, using efficient serialization via orjson and mashumaro.

Yes, if you are working within the Music Assistant ecosystem. The package is actively maintained, has low install friction, carries a permissive license, and has no known vulnerabilities. Install it only if you are building Music Assistant clients, plugins, or integrations; it is not a standalone tool for general music streaming use.

## Install

pip install music-assistant-models
uv add music-assistant-models
poetry add music-assistant-models

## Installing music-assistant-models

Before you install: Active maintenance with a release 1 day old. Low install friction—pure Python wheel with only three lightweight runtime dependencies (orjson, mashumaro, unidecode). Requires Python 3.11 or later.

License in practice: Licensed under Apache-2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart:

pip install music-assistant-models

from music_assistant_models import SomeModel  # Import a model class
model_instance = SomeModel()  # Instantiate and use

Requires Python 3.11 or later; earlier versions are not supported.

Verify before relying:

- What specific model classes and data structures are exported and what they represent in the Music Assistant ecosystem.
- Whether this package is intended for end-user applications or primarily for Music Assistant internal/plugin development.
- Performance characteristics or serialization benchmarks compared to alternative approaches.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 255.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

music assistant models, shared data models music, music streaming serialization, client server music models, music assistant types, music-streaming, data-models, serialization

[View on SkillFed](https://skillfed.io/packages/music-assistant-models) · [View on PyPI](https://pypi.org/project/music-assistant-models/)