Ryzen AI Robotics, Vision and ML Dockerfiles

This repository provides a collection of composable Dockerfiles and build scripts for deploying and running software, full applications, and select demonstrators on AMD Ryzen AI hardware. The project is designed to streamline the setup of AI workloads, robotics, vision, and other applications optimized for Ryzen AI.

---

Overview

Ryzers is a modular framework for building and running Docker containers tailored for AMD Ryzen AI hardware. It supports a wide range of applications, including machine learning, robotics, vision, and more. The repository is structured to allow easy composition of Dockerfiles, enabling users to build custom containers for their specific needs.

These dockerfiles will also be pushed and actively maintained in their original repository homes whenever possible. Ryzers will be a collection point of software frameworks to run on AMD hardware. We are committed to open-source and happy to accept contributions or feedback on packages hosted here.

---

Supported Packages

---

Installation

To get started, clone the repository and install the required dependencies:

git clone https://github.com/AMDResearch/Ryzers
pip install Ryzers/

For detailed installation instructions and requirements, refer to the included documentation.

Usage

Simple Example

ryzers build genesis
ryzers run 

# Alternatively, override the Dockerfile's CMD to run a custom command
ryzers run bash

For detailed build and run instructions, refer to the instructions included in the package.

Features

• Verified AMD Support for Popular Frameworks: A variety of Robotics and ML software frameworks supported across Ryzen AI platforms.
• Optimized for Ryzen AI: Includes support for hardware-accelerated AI workloads and accelerators like the iGPU and NPUs.
• Minimal Host Software Requirements: Standard Ubuntu support with minimal software requirements
• Composable Dockerfiles: Modular design for reusability across different applications.

---

Contributing

We welcome contributions to Ryzers! If you have ideas for new features, bug fixes, or improvements, please submit a pull request or open an issue.

Using an AI coding agent? Point it at skills/new-ryzer/SKILL.md — it has everything an agent needs to scaffold a new package correctly (templates, conventions, config schema, and reference examples). Works with any agent: Claude Code, Codex, Cursor, Copilot, etc.

For detailed guidelines, see CONTRIBUTING.md.

---

License

This project is licensed under the MIT license. See the LICENSE file for details.