fame-pytorch-kit / README.md
sbeierle's picture
Update README.md
17c17fe verified
---
license: mit
language:
- en
- ar
tags:
- rocm
- amd
- gpu
- build-environment
- pytorch
- custom-build
- deep-learning
- machine-learning
- llm-enigneering
- arabic
- multilingual
- bilingual
---
# Fame PyTorch ROCm Kit 🔥🛡️
Built with Courage. Built with Fire. Built with Fame.
![Banner](https://huggingface.co/sbeierle/fame-pytorch-kit/resolve/main/built_with_fame.png)
---
## 🚀 About
This project provides a complete and clean build kit for compiling a working PyTorch ROCm version on AMD GPUs – without the usual headaches involving ROCm, HIP, OpenMP, or Git submodules.
You will find everything needed to build, install, and test PyTorch from source, generating a valid `.whl` package for your local machine.
---
## 📋 Project Structure
| File/Folder | Purpose |
|:------------|:--------|
| `build_torch.sh` | Script to build PyTorch from source |
| `install_torch.sh` | Script to install the generated Wheel file |
| `test_torch.sh` | Script to test PyTorch import and ROCm status |
| `fame_torch_freeze.txt` | Environment freeze (package versions) |
| `pytorch-wheel/` | (Optional) Folder containing the `.whl` file |
| `MY_WHEELI_NOTES.md` | Notes related to the Wheel build |
| `PyTorch_ROCm_Build_Notes.md` | Extended ROCm build notes |
| `README.md` | This document – the Fame Masterplan |
---
## 🛠️ Build Instructions
1. **Activate your ROCm environment**
```bash
source ~/rocm_env/bin/activate
```
2. **Navigate to the project folder**
```bash
cd fame-pytorch-kit/
```
3. **Build PyTorch**
```bash
bash build_torch.sh
```
The generated `.whl` file will be located in `pytorch/dist/`.
---
## 📦 Install Instructions
### Quick Install
```bash
bash install_torch.sh
```
### Manual Install
```bash
cd pytorch/dist/
pip install torch-2.8.0a0+gitc402b3b-cp312-cp312-linux_x86_64.whl
```
Make sure your Python environment (venv) is activated!
---
## ✅ Test Instructions
```bash
bash test_torch.sh
```
Or manually:
```bash
python -c "import torch; print(torch.cuda.is_available())"
python -c "import torch; print(torch.cuda.get_device_name(0))"
python -c "import torch; print(torch.version.hip)"
```
Expected: `True`, GPU Name, HIP version string.
---
## 📜 License
This project is licensed under the MIT License.
---
## 🤝 Credits
Fame Kit proudly built by [sbeierle](https://github.com/sbeierle) with 🛡️ Courage, 🔥 Fire, and 🚀 Fame.
---
# Built with Fire. Built with Fame. 🛡️🔥
---
# Fame PyTorch ROCm Kit 🔥
مُصمم بشجاعة. مُصمم ببراعة. مُصمم بشغف.
---
## 🚀 حول
يوفر هذا المشروع مجموعة بناء كاملة ومنظمة لتجميع نسخة PyTorch ROCm عاملة على وحدات معالجة الرسومات AMD - دون عناء استخدام وحدات ROCm أو HIP أو OpenMP أو Git الفرعية.
ستجد كل ما تحتاجه لبناء PyTorch وتثبيته واختباره من المصدر، مع إنشاء حزمة `.whl` صالحة لجهازك المحلي.
---
## 📋 هيكل المشروع
| ملف/مجلد | الغرض |
|:-----------|:--------|
| `build_torch.sh` | سكربت لبناء PyTorch من المصدر |
| `install_torch.sh` | سكربت تثبيت ملف Wheel المُولّد |
| `test_torch.sh` | سكربت لاختبار استيراد PyTorch وحالة ROCm |
| `fame_torch_freeze.txt` | تجميد البيئة (إصدارات الحزمة) |
| `pytorch-wheel/` | (اختياري) المجلد الذي يحتوي على ملف `.whl` |
| `MY_WHEELI_NOTES.md` | ملاحظات متعلقة ببناء Wheel |
| `PyTorch_ROCm_Build_Notes.md` | ملاحظات بناء ROCm الموسعة |
| `README.md` | هذه الوثيقة - الخطة الرئيسية لـ Fame |
---
## 🛠️ تعليمات البناء
1. **تفعيل بيئة ROCm**
```bash
source ~/rocm_env/bin/activate
```
2. **انتقل إلى مجلد المشروع**
```bash
cd fame-pytorch-kit/
```
3. **بناء PyTorch**
```bash
bash build_torch.sh
```
سيكون ملف `.whl` المُنشأ موجودًا في `pytorch/dist/`.
---
## 📦 تعليمات التثبيت
### تثبيت سريع
```bash
bash install_torch.sh
```
### تثبيت يدوي
```bash
cd pytorch/dist/
pip install torch-2.8.0a0+gitc402b3b-cp312-cp312-linux_x86_64.whl
```
تأكد من تفعيل بيئة بايثون (venv) لديك!
---
## ✅ تعليمات الاختبار
```bash
bash test_torch.sh
```
أو يدويًا:
```bash
python -c "import torch; print(torch.cuda.is_available())"
python -c "import torch; print(torch.cuda.get_device_name(0))"
python -c "import torch; print(torch.version.hip)"
```
المتوقع: `True`، اسم وحدة معالجة الرسومات، سلسلة إصدار HIP.
---
## 📜 الترخيص
هذا المشروع مرخص بموجب ترخيص معهد ماساتشوستس للتكنولوجيا (MIT).
---
## 🤝 شكر وتقدير
مجموعة الشهرة مصممة بفخر من قِبل [sbeierle](https://github.com/sbeierle) بشجاعة 🛡️، وحماس 🔥، وشهرة 🚀.
---
# صُنعت بالنار. صُنعت بالشهرة. 🛡️🔥
# Fame PyTorch ROCm Kit 🔥