Add Docker Model Runner documentation and compatibility tests

Add documentation for using Docker Model Runner with ModelPack models,
including detection mechanism, field mappings, and media type conversions.
Add downstream compatibility validation tests to prevent accidental
breakage of fields and media types that downstream consumers depend on.

Closes #151

Signed-off-by: Pradhyum Rajasekar <pradhyum314@gmail.com>
Signed-off-by: pradhyum6144 <pradhyum314@gmail.com>

Author: pradhyum6144

docs/docker-model-runner.md

@@ -0,0 +1,114 @@
+# Using Docker Model Runner with ModelPack
+
+This guide shows you how to use [Docker Model Runner](https://docs.docker.com/desktop/features/model-runner/) to pull and run AI models packaged using the ModelPack specification.
+
+## What is Docker Model Runner?
+
+Docker Model Runner is a built-in feature of Docker Desktop that enables pulling, managing, and running AI models directly from OCI registries. It natively supports the ModelPack specification format, allowing you to run ModelPack-packaged models without any additional tools.
+
+## Prerequisites
+
+- [Docker Desktop](https://docs.docker.com/get-docker/) 4.40 or later with Model Runner enabled
+- A ModelPack-compatible model pushed to an OCI registry (see [modctl](./modctl.md) or [AIKit](./aikit.md) for packaging)
+
+## Enable Docker Model Runner
+
+Docker Model Runner is available through Docker Desktop. Enable it in Docker Desktop settings:
+
+1. Open Docker Desktop
+2. Go to **Settings** > **Features in development**
+3. Enable **Docker Model Runner**
+
+You can verify it is enabled by running:
+
+```bash
+docker model list
+```
+
+## Pull a ModelPack Model
+
+Docker Model Runner can pull models directly from OCI registries. When pulling a ModelPack-formatted artifact, Docker automatically detects the ModelPack config format and converts it for local use.
+
+```bash
+# Pull a model from an OCI registry
+docker model pull myregistry.com/mymodel:v1.0
+```
+
+## Run a Model
+
+Once pulled, you can run inference using the model:
+
+```bash
+# Run a model interactively
+docker model run myregistry.com/mymodel:v1.0
+
+# Send a prompt to the model
+docker model run myregistry.com/mymodel:v1.0 "Explain cloud-native computing"
+```
+
+## List and Manage Models
+
+```bash
+# List all downloaded models
+docker model list
+
+# Remove a model
+docker model rm myregistry.com/mymodel:v1.0
+```
+
+## Use Models via the OpenAI-Compatible API
+
+Docker Model Runner exposes an OpenAI-compatible API endpoint, enabling integration with existing tools and libraries:
+
+```bash
+curl http://localhost:12434/engines/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "myregistry.com/mymodel:v1.0",
+    "messages": [{"role": "user", "content": "Hello!"}]
+  }'
+```
+
+## How ModelPack Format Is Detected
+
+Docker Model Runner identifies a ModelPack artifact by checking the OCI config blob for any of the following fields:
+
+- `config.paramSize` — the model parameter size
+- `descriptor.createdAt` — the model creation timestamp
+- `modelfs` — the model filesystem descriptor
+
+If any of these fields are present, the artifact is recognized as a ModelPack-formatted model.
+
+## Field Mapping: ModelPack to Docker
+
+When Docker Model Runner pulls a ModelPack model, it converts the config fields to Docker's internal format:
+
+| ModelPack Field | Docker Field | Description |
+|---|---|---|
+| `descriptor.createdAt` | `created` | Model creation timestamp |
+| `descriptor.name` | `descriptor.name` | Model name |
+| `descriptor.family` | `descriptor.family` | Model family |
+| `descriptor.description` | `descriptor.description` | Model description |
+| `descriptor.licenses` | `descriptor.licenses` | License information |
+| `config.paramSize` | `parameters` | Model parameter count |
+| `config.format` | `config.format` | Model format (e.g., GGUF) |
+| `config.quantization` | `config.quantization` | Quantization method |
+| `config.architecture` | `config.architecture` | Model architecture |
+| `modelfs` | `rootfs` | Layer content addresses |
+
+## Media Type Mapping
+
+ModelPack media types are converted to Docker's internal media types:
+
+| ModelPack Media Type | Docker Media Type |
+|---|---|
+| `application/vnd.cncf.model.weight.v1.raw` | Mapped based on file extension (e.g., `.gguf` → `application/vnd.docker.ai.gguf.v3`) |
+| `application/vnd.cncf.model.weight.v1.tar+gzip` | `application/vnd.docker.ai.gguf.v3+gzip` |
+| `application/vnd.cncf.model.weight.config.v1.raw` | `application/vnd.docker.ai.config` |
+| `application/vnd.cncf.model.doc.v1.raw` | `application/vnd.docker.ai.doc` |
+
+## Next Steps
+
+- **Package models** using [modctl](./modctl.md) or [AIKit](./aikit.md) to create ModelPack artifacts
+- **Learn about the [Model CSI Driver](https://github.com/modelpack/model-csi-driver)** for Kubernetes integration
+- **Read the [full ModelPack specification](./spec.md)** for technical implementation details

docs/getting-started.md

@@ -35,6 +35,7 @@ This section lists the core infrastructure components that ModelPack is working
 - **[modctl](https://github.com/modelpack/modctl)**: CLI tool for building, pushing, pulling, and managing OCI model artifacts
 - **[KitOps](https://kitops.ml/)**: ModelKit packaging and deployment platform that supports the ModelPack specification
 - **[AIKit](https://kaito-project.github.io/aikit/docs/packaging)**: Package AI models as OCI artifacts from local, HTTP, or Hugging Face sources with extensible formats, including ModelPack specification
+- **[Docker Model Runner](https://docs.docker.com/desktop/features/model-runner/)**: Pull and run ModelPack models directly from OCI registries using Docker Desktop
 
 ### Kubernetes Integration
 
@@ -65,6 +66,7 @@ The ModelPack specification can be used with different tools depending on your n
 - **[modctl](./modctl.md)**: CLI tool for building, pushing, pulling, and managing OCI model artifacts. Great for command-line workflows and CI/CD pipelines.
 - **[AIKit](./aikit.md)**: Package AI models as OCI artifacts from local, HTTP, or Hugging Face sources with extensible formats.
 - **[KitOps](https://kitops.ml/)**: ModelKit packaging and deployment platform that supports the ModelPack specification.
+- **[Docker Model Runner](./docker-model-runner.md)**: Pull and run ModelPack models directly from OCI registries using Docker Desktop.
 
 ### Install Model CSI Driver
 
@@ -100,7 +102,7 @@ This example shows how to mount a model artifact directly into a Kubernetes pod
 
 ## Next Steps
 
-1. **Get hands-on experience**: Follow the step-by-step guides for [modctl](./modctl.md) or [AIKit](./aikit.md)
+1. **Get hands-on experience**: Follow the step-by-step guides for [modctl](./modctl.md), [AIKit](./aikit.md), or [Docker Model Runner](./docker-model-runner.md)
 2. **Explore the [full ModelPack specification](./spec.md)** for technical implementation details
 3. **Join the community** on [CNCF Slack #modelpack](https://cloud-native.slack.com/archives/C07T0V480LF)
 4. **Contribute** to the ModelPack project - see our [contributing guidelines](../CONTRIBUTING.md)
@@ -114,5 +116,6 @@ This example shows how to mount a model artifact directly into a Kubernetes pod
 - [KitOps](https://kitops.ml/)
 - [Hugging Face](https://huggingface.co/)
 - [AIKit](https://github.com/kaito-project/aikit)
+- [Docker Model Runner](https://docs.docker.com/desktop/features/model-runner/)
 
 The ModelPack specification represents the next evolution in infrastructure standardization, bringing the benefits of containerization to AI model management. Start with the basics, explore the ecosystem, and join our growing community of contributors and users building the future of cloud-native AI.