guide-odin

Orchestrate Kubernetes InferenceService workloads by reconciling CRDs into Deployments or LeaderWorkerSets.

Updated Oct 23, 2025
One-click install
npx skills add https://github.com/moreh-dev/mif --skill guide-odin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: guide-odin
Source: https://github.com/moreh-dev/mif/tree/main/skills/guide-odin
Command: npx skills add https://github.com/moreh-dev/mif --skill guide-odin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Odin orchestrates and reconciles InferenceService workloads in Kubernetes, enabling scalable, repeatable deployment of AI inference workloads via a reusable, template-driven configuration system.

Core Features & Use Cases

  • Template composition with InferenceServiceTemplate to layer runtime-bases and presets, enabling clean separation of platform and model configurations.
  • Support for multiple parallelism styles (tensor, pipeline, data, expert) and workload types (Deployment or LeaderWorkerSet) to fit varied model and hardware layouts.
  • End-to-end deployment patterns for vLLM-based serving, multi-node setups, and PD-disaggregation workflows, with rollback and rollout controls.

Quick Start

Run Odin in your cluster to deploy your first InferenceService using the vLLM presets and templates.

Frequently Asked Questions about guide-odin

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a vLLM InferenceService on Kubernetes using Odin?

To deploy a vLLM InferenceService on Kubernetes, Odin reconciles your custom resources into Deployments or LeaderWorkerSets using reusable templates and presets for scalable AI inference workloads.

What is the difference between Deployment and LeaderWorkerSet topologies for inference workloads?

Deployment and LeaderWorkerSet topologies in Odin dictate workload layout for inference. LeaderWorkerSets support multi-node setups and parallelism patterns, while standard Deployments fit simpler single-node configurations.

How does Odin resolve InferenceServiceTemplate references and merge presets?

Odin resolves InferenceServiceTemplate references by layering runtime-bases and presets, applying variable substitution and merge semantics to cleanly separate platform configurations from model-specific settings.

Can I use tensor, pipeline, data, and expert parallelism with InferenceService?

Yes, InferenceService supports tensor, pipeline, data, and expert parallelism styles. Odin reconciles these configurations to correctly provision the underlying Kubernetes workload topology and worker templates.

Why is my Odin InferenceService workload not reconciling correctly in Kubernetes?

Odin InferenceService reconciliation failures often stem from invalid template references, incorrect merge semantics, or webhook validation errors during runtime-base selection and workload topology configuration.

Do I need LeaderWorkerSet for multi-node vLLM serving and PD-disaggregation?

Yes, LeaderWorkerSet is required for multi-node vLLM serving and PD-disaggregation workflows. Odin uses this topology to manage complex worker layouts and rollout strategies for distributed inference.