# k8s-ai-conformance **Repository Path**: mirrors_cncf/k8s-ai-conformance ## Basic Information - **Project Name**: k8s-ai-conformance - **Description**: No description available - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-11-15 - **Last Updated**: 2026-04-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Kubernetes AI Conformance ![Kubernetes AI Conformance](https://github.com/cncf/artwork/blob/main/projects/kubernetes/certified-kubernetes-ai/versionless/color/CNCF_AI_Conformance_Logo-Color-V2.png) **A standardized approach to running AI/ML workloads on Kubernetes** [![CNCF Project](https://img.shields.io/badge/CNCF-Project-blue)](https://www.cncf.io/) [![Kubernetes](https://img.shields.io/badge/Kubernetes-1.33%20%7C%201.34%20%7C%201.35-326CE5?logo=kubernetes)](https://kubernetes.io/) [Get Certified](#for-vendors) · [Contribute](#for-contributors) · [FAQ](faq.md) · [AI Conformance Project](https://github.com/kubernetes-sigs/ai-conformance) If you're here to get certified, start at [For Vendors](#for-vendors). If you're here to help shape the program, jump to [For Contributors](#for-contributors). --- ## Table of Contents - [What is this?](#what-is-this) - [Getting Started](#getting-started) - [For Vendors](#for-vendors) - [For Contributors](#for-contributors) - [How Certification Works](#how-certification-works) - [Requirements Overview](#requirements-overview) - [Resources](#resources) - [Community](#community) --- ## What is this? The Kubernetes AI Conformance Program defines the capabilities a Kubernetes platform needs to reliably run AI and machine learning workloads. The goal is simple: if your AI application works on one conformant platform, it should work on others too—with fewer "it works on my cluster" surprises. ### Why does this matter? AI/ML workloads tend to stress clusters in unique ways (accelerators, bursty traffic, and strict isolation). Today, those capabilities vary across platforms. This program aims to: - Make AI/ML workloads more portable across Kubernetes platforms - Reduce platform-specific workarounds and "it works on my cluster" surprises - Give the AI tooling ecosystem a clear baseline to build and test against ### What workloads does this cover? We're focusing on the most common AI/ML use cases: - **Training** - Distributed or large training jobs that need accelerators and predictable scheduling - **Inference** - Model/LLM serving where latency, routing, and scaling matter - **Agentic workloads** - Multi-step workflows that combine tools, memory, and long-running tasks --- ## Getting Started ### For Vendors If you provide a Kubernetes platform and want to get certified, here's what you need to know. Most submissions are a completed checklist plus links to public evidence—think of it as a structured, reviewable self-assessment. **Before you start:** Your platform must already be [Kubernetes Conformant](https://github.com/cncf/k8s-conformance). AI conformance builds on top of base Kubernetes conformance. #### The certification process 1. **Prepare** - Review the [certification requirements](terms-conditions/Certified_AI_Platform.md) and make sure your platform meets them 2. **Document** - Fill out the conformance checklist and gather evidence (documentation, test results, etc.) 3. **Submit** - Create a pull request with your submission to the https://github.com/cncf/k8s-ai-conformance repo. 4. **Review** - CNCF reviews your submission (typically takes up to 10 business days) #### What you'll need to submit - A completed conformance checklist (YAML file) - Public documentation showing how your platform meets each requirement - Your product logo in vector format (SVG, EPS, or AI) - Proof of Kubernetes conformance **Note:** Today, certification is based on self-assessment. Automated conformance tests are planned for 2026. For detailed instructions on what to include, see [instructions.md](instructions.md#contents-of-the-pr). --- ### For Contributors The program is a community-led effort to establish a vendor-neutral baseline for AI portability. We welcome participation from all stakeholders, including end users, to ensure the standard remains independent and effective. #### Ways to contribute | Area | What you can do | |------|----------------| | **Documentation** | Help improve guides, add examples, fix typos, clarify confusing parts | | **Research** | Identify requirements for new AI workload types (especially agentic workloads) | | **Testing** | Help develop automated conformance tests | | **Discussion** | Participate in project meetings and design discussions | #### How to get involved 1. [Open an issue](https://github.com/kubernetes-sigs/ai-conformance/issues) — have an idea, question, or suggestion? Start here. 2. Join the [AI Conformance project meetings](https://github.com/kubernetes/community/tree/master/sig-architecture#meetings). 3. Check out the [project boards](https://github.com/kubernetes-sigs/ai-conformance/projects?query=is%3Aopen) to see what's in progress. --- ## How Certification Works ```mermaid flowchart TD A[Platform must be Kubernetes Conformant] --> B[Complete self-assessment checklist] B --> C[Gather evidence and documentation] C --> D[Submit pull request] D --> E[CNCF reviews submission] E -->|Approved| F[Certified for 1 year] E -->|Needs changes| B ``` **Important notes:** - Certifications are valid for one year and must be renewed - Certification is per-product and per-configuration (e.g., cloud vs air-gapped) - The conformance requirements are aligned with Kubernetes release cycles --- ## Requirements Overview Platforms need to demonstrate capabilities across several areas: accelerators, networking, scheduling, observability, security, and operator support. The specifics evolve with each Kubernetes release. For the full and up-to-date requirements, see the [conformance versions](https://github.com/kubernetes-sigs/wg-ai-conformance/tree/main/conformance-versions) in the WG repo. --- ## Resources ### Documentation - [FAQ](faq.md) - Common questions about the program - [Instructions](instructions.md) - How to prepare and submit your conformance results - [Terms & Conditions](terms-conditions/Certified_AI_Platform.md) - Legal requirements for certification ### Conformance Checklists Pick the one that matches your Kubernetes version: - [AIConformance-1.35.yaml](docs/AIConformance-1.35.yaml) (latest) - [AIConformance-1.34.yaml](docs/AIConformance-1.34.yaml) - [AIConformance-1.33.yaml](docs/AIConformance-1.33.yaml) ### Related Projects - [Kubernetes Conformance](https://github.com/cncf/k8s-conformance) - Base Kubernetes certification (required first) - [Conformance Tests](https://github.com/kubernetes/kubernetes/blob/master/test/conformance/testdata/conformance.yaml) - Kubernetes test suite - [Verify Conformance Bot](https://github.com/kubernetes-sigs/verify-conformance) - Automation coming soon --- ## Community ### Kubernetes Subproject The [Kubernetes AI Conformance](https://github.com/kubernetes-sigs/ai-conformance) project governs this program and defines the conformance requirements. - **Meetings:** Check the [AI Conformance project meetings](https://github.com/kubernetes/community/tree/master/sig-architecture#meetings) - **Contact:** sig-architecture@kubernetes.io ([mailing list](https://groups.google.com/a/kubernetes.io/g/sig-architecture)) and [Slack channel](https://kubernetes.slack.com/messages/k8s-ai-conformance) ### Certified Platforms See all certified platforms in the version directories: - [v1.35/](/v1.35/) - [v1.34/](/v1.34/) - [v1.33/](/v1.33/) ### Need Help? - Read the [FAQ](faq.md) first - Ask questions in the Kubernetes AI Conformance project - [Open an issue](https://github.com/cncf/k8s-ai-conformance/issues) - Email conformance@cncf.io For private review of unreleased products, contact conformance@cncf.io directly. --- ## License Apache License 2.0 - see [LICENSE](LICENSE) for details.