Skip to content

Latest commit

 

History

History
390 lines (311 loc) · 22 KB

File metadata and controls

390 lines (311 loc) · 22 KB
AMD YES! 🚀

開源 · 社群驅動 · 讓 AMD AI 生態更好用

English 簡體中文 繁體中文 日本語 Español Français 한국어 العربية Tiếng_Việt Deutsch

AMD University Program      AMD ROCm

  自 ROCm 7.10.0(2025 年 12 月 11 日釋出)起,ROCm 已可像 CUDA 一樣在 Python 虛擬環境中無縫安裝,並正式支援 Linux 與 Windows 雙平台。這是 AMD 在 AI 領域的一大突破——學習者與大型語言模型愛好者在硬體選擇上不再只有 NVIDIA,AMD GPU 正成為一個有力的競爭選項。

  然而,硬體門檻降低並不代表學習路徑自動變得清晰。對於已經有大型語言模型基礎、想要在 AMD GPU 上實際動手的學習者來說,真正的挑戰才剛開始:怎麼在 AMD GPU 上把一個模型跑起來?怎麼在這個基礎上做微調與訓練?怎麼理解 ROCm 的 GPU 程式設計體系,完成從 CUDA 到 ROCm 的轉移?最終,這些能力又如何匯聚成一個可以實際上線的 AI 應用?

  hello-rocm 正是為這條路徑而生。本專案系統性地涵蓋 AMD ROCm 平台上大型語言模型的完整使用流程,帶你從把第一個模型跑起來,走到在 AMD GPU 上打造真實 AI 應用,中間經過微調訓練與 GPU 程式設計的每一個關鍵環節——讓 AMD GPU 不只是一張顯示卡,而是你進入 AI 開發世界的真實起點。

  這個專案的核心內容就是教學,讓更多學生和未來的從業者了解並熟悉 AMD ROCm 的使用方式!任何人都可以提出 issue 或送出 PR,一起共建維護這個專案。

  學習建議:建議先完成 00-Environment 中的環境安裝(ROCm + PyTorch + uv),再學習部署與微調,最後探索算子最佳化與 GPU 程式設計。初學者可在環境就緒後從 LM Studio 或 vLLM 部署開始。

hello-rocm Skill:把本專案裝進你的 AI 助手

  如果你使用支援 Skills、Rules 或 Agent 設定的 AI 程式開發工具,可以直接使用本專案內建的 hello-rocm Skill。它會根據本儲存庫的目錄結構、Reference 索引、GPU 架構表、部署教學和疑難排解清單,為你定位到具體文件與官方連結。

請使用當前儲存庫的 src/hello-rocm-skill 作為 hello-rocm Skill;如果你的工具支援 Skills、Rules 或 Agent 設定,請把它安裝或載入到合適位置(例如 .claude/skills、.cursor/skills 或 .agents/skills),然後根據該 Skill 幫我學習、部署和排查 AMD ROCm。

  你可以這樣問:我的 AMD GPU 能不能跑 ROCm?我想最快跑通一個本地大型語言模型應該看哪篇?vLLM / Ollama / llama.cpp 在 ROCm 上怎麼裝?torch.cuda.is_available() 回傳 False 怎麼排查?更多說明見 hello-rocm Skill 使用指南

最新動態

已支援模型

✨ 主流大型語言模型:環境設定 · 多框架推論 · 微調實作 ✨
ROCm 統一環境安裝(Windows / Ubuntu)+ ROCm 7+ · 按模型分目錄教學(持續擴充)
00-環境安裝教學

Qwen3
LM Studio 部署
vLLM 部署
Ollama 部署
llama.cpp 部署
Qwen3-0.6B LoRA 微調
Qwen3-8B LoRA 微調
Qwen3.5
LM Studio 部署
vLLM 部署
Ollama 部署
llama.cpp 部署
Qwen3.5-4B LoRA 微調
Qwen3.5-4B LoRA 微調 Notebook
Gemma4
Gemma 4 模型介紹
LM Studio 部署
vLLM 部署
Ollama 部署
llama.cpp 部署
Gemma4 - E4B LoRA 微調(基於 TRL)
MiniCPM5
llama.cpp 部署
MiniCPM-V 4.6
llama.cpp 部署
vLLM 部署
MiniCPM-o 4.5
MiniCPM-o 4.5 模型介紹
llama.cpp-omni 部署(語音+視覺+TTS)
Web Demo 全雙工部署
具身智能策略(ACT / SmolVLA / Pi0 / Pi0.5)
ROCm 具身智能策略複刻案例
ACT ROCm 訓練 Notebook
SmolVLA ROCm 訓練 Notebook
Pi0 ROCm 訓練 Notebook
Pi0 嚴格端到端診斷 Notebook
Pi0.5 EEF-delta 訓練 Notebook

專案意義

  什麼是 ROCm?

ROCm(Radeon Open Compute)是 AMD 推出的開源 GPU 運算平台,為高效能運算和機器學習提供開放的軟體堆疊。它讓 AMD GPU 也能跑平行運算,是 CUDA 在 AMD 平台上的替代方案。

  百模大戰正值火熱,開源大型語言模型層出不窮。然而,目前大多數大型語言模型教學和開發工具都建立在 NVIDIA CUDA 生態之上。對於想要使用 AMD GPU 的開發者來說,缺乏系統性的學習資源一直是痛點。

  自 ROCm 7.10.0(2025 年 12 月 11 日)起,AMD 透過 TheRock 專案對 ROCm 底層架構進行了重構,將運算執行環境與作業系統脫鉤,使同一套 ROCm 上層介面可以同時運行在 Linux 與 Windows 上,並支援像 CUDA 一樣直接安裝到 Python 虛擬環境中使用。這意味著 ROCm 不再是只面向 Linux 的「工程工具」,而是升級為一個真正面向 AI 學習者與開發者的跨平台 GPU 運算平台——不論使用 Windows 還是 Linux,使用者都可以更低門檻地使用 AMD GPU 進行訓練和推論,大型語言模型與 AI 玩家在硬體選擇上不再被 NVIDIA 單一生態綁定,AMD GPU 正逐步成為一個可以被一般使用者真正用起來的 AI 運算平台。

  本專案旨在基於核心貢獻者的經驗,提供 AMD ROCm 平台上大型語言模型部署、微調、訓練的完整教學;我們希望充分匯聚共創者,一起豐富 AMD AI 生態。

  我們希望成為 AMD GPU 與廣大使用者之間的橋樑,以自由、平等的開源精神,擁抱更遼闊的 AI 世界。

專案受眾

  本專案適合以下學習者:

  • 手邊有一張 AMD 顯示卡,想體驗一下大型語言模型在本機運行;
  • 想要使用 AMD GPU 進行大型語言模型開發,但找不到系統性的教學;
  • 希望以低成本、高 CP 值的方式部署和運行大型語言模型;
  • 對 ROCm 生態感興趣,想要親自上手實作;

專案規劃及進展

  本專案擬圍繞 ROCm 大型語言模型應用全流程組織,包括統一環境基線(00-Environment)、部署應用、微調訓練、算子最佳化等:

專案結構

hello-rocm/
├── docs/                   # VitePress 文件源碼
│   ├── zh/                 # 中文文件
│   │   ├── 00-environment/ # ROCm 基礎環境安裝與設定
│   │   ├── 01-deploy/      # ROCm 大型語言模型部署實作
│   │   ├── 02-fine-tune/   # ROCm 大型語言模型微調實作
│   │   ├── 03-infra/       # ROCm 算子最佳化實作
│   │   ├── 04-references/  # ROCm 優質參考資料
│   │   └── 05-amd-yes/     # AMD 實作案例集合
│   └── en/                 # English docs
├── src/                    # 原始碼與腳本
└── assets/                 # 公用資源

00. Environment - ROCm 基礎環境

🛠️ ROCm 基礎環境安裝與設定
統一環境基線 · ROCm 7.12.0 · Windows / Ubuntu · uv + PyTorch
📖 Getting Started with ROCm Environment

GPU 架構與 pip 索引對照表
• Windows 11 安裝、驅動與安全性前置說明
• Ubuntu 24.04 安裝(uv 方式與備選一鍵腳本)
• 安裝驗證、移除與切換其他 GPU 架構

01. Deploy - ROCm 大型語言模型部署

🚀 ROCm 大型語言模型部署實作
零基礎快速上手 AMD GPU 大型語言模型部署
📖 Getting Started with ROCm Deploy

• LM Studio 零基礎大型語言模型部署
• vLLM 零基礎大型語言模型部署
• Ollama 零基礎大型語言模型部署
• llama.cpp 零基礎大型語言模型部署
• ATOM 零基礎大型語言模型部署

02. Fine-tune - ROCm 大型語言模型微調

🔧 ROCm 大型語言模型微調實作
在 AMD GPU 上進行高效模型微調
📖 Getting Started with ROCm Fine-tune

• 大型語言模型零基礎微調教學
• 大型語言模型單機微調腳本
• 大型語言模型多機多卡微調教學

03. Infra - ROCm 算子最佳化與 GPU 程式設計

⚙️ ROCm 算子最佳化與 GPU 程式設計
從 AMD AI 硬體全景到 HIP 算子與效能分析
📖 開始學習 ROCm 算子最佳化與 GPU 程式設計

• AMD AI 硬體全景與 ROCm 生態
• GPU 軟體堆疊與硬體架構深度解析
• HIP 程式設計入門與手寫 Kernel 實戰
• 自訂 PyTorch 算子與 Autograd 整合

04. References - ROCm 優質參考資料

📚 ROCm 優質參考資料
精選的 AMD 官方與社群資源
📖 ROCm References

ROCm 官方文件
AMD GitHub
ROCm Release Notes
AMD GPU 架構白皮書(CDNA / RDNA)
框架與推論服務 ROCm 快速安裝入口
• 相關新聞

05. AMD-YES - AMD 實作案例集合

✨ AMD 實作案例集合
社群驅動的 AMD GPU 專案實作
📖 Getting Started with ROCm AMD-YES

• toy-cli - LLM 輕量化終端助手
• Minesweeper Agent - 用本地大模型玩掃雷(Agent 循環實踐)
• YOLOv10 微信跳一跳 - 遊戲 AI 實戰(在 ROCm 環境下訓練並使用 yolov10)
• Chat-甄嬛 - 古風對話大型語言模型
• 智能旅行規劃助手 - HelloAgents Agent 實戰
• Torch-RecHub - 推薦系統實戰(CTR、召回、多任務、ONNX 導出)
• happy-llm - 分散式大型語言模型訓練
Every Embodied - ROCm 具身智能策略複刻

貢獻指南

  我們歡迎所有形式的貢獻!不論是:

  • 完善或新增教學
  • 修復錯誤與 Bug
  • 分享你的 AMD 專案
  • 提出建議與想法

  參與前請先閱讀 Content Guide(目錄、命名、配圖與文件結構與 Qwen3 / Qwen3.5 等教學對齊),再閱讀 CONTRIBUTING_en.md(Issue / PR 流程與模型專項目錄約定)。

  如果你在使用 ROCm、部署模型或閱讀教學時遇到疑難排解與常見問題,也歡迎加入我們的 社群討論,和社群一起補充經驗、回報問題、完善教學。

  想要深度參與的同學可以聯繫我們,我們會將你加入到專案的維護者中。

致謝

核心貢獻者

註:歡迎更多貢獻者加入!

其他

  • 如果有任何想法可以聯繫我們,也歡迎大家多多提出 issue
  • 特別感謝以下為教學做出貢獻的同學!
  • 感謝 AMD University Program 對本專案的支持!!

License

MIT License


讓我們一起打造 AMD AI 的未來! 💪

Made with ❤️ by the hello-rocm community