# quark-install

Ставит и проверяет AMD Quark в выбранном окружении Python, подбирая PyTorch под имеющийся ускоритель. Пригодится, когда импорт quark падает или ядро не компилируется.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 526 установок · ★ 465
- Автор: amd
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/amd/skills/tree/HEAD/skills/quark-install/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/quark-install

## Что делает

Скилл сам смотрит на железо: определяет интерпретатор Python, версию PyTorch и бэкенд, доступность GPU. Дальше выбирает минимальный безопасный вариант установки и выполняет его только после подтверждения. По умолчанию режим GPU, на CPU переходит лишь после явного согласия пользователя — молча поставить CPU-сборку он не даст.

Поддерживаются четыре источника: универсальный wheel с PyPI, нативный wheel из индекса AMD, локальный wheel и локальная папка с исходниками. Универсальный вариант компилирует ядра Quark при первом запуске, поэтому может понадобиться компилятор C++ и `nvcc` или `hipcc`. Нативный wheel подбирается не по таблице, а по факту: имя файла должно точно совпадать с версией PyTorch, тегом CUDA/ROCm, версией CPython, ОС и архитектурой. Для импорта Quark Torch нужен Transformers, хотя базовый wheel его не требует — скилл считает отсутствующий модуль ошибкой зависимостей, а не сбоем компилятора.

Нужен Python 3.11, 3.12 или 3.13 и PyTorch 2.2 или новее. Сам `amd-quark` PyTorch не тянет, поэтому сначала проверяется torch. Если он отсутствует, собран только под CPU или не видит GPU, работа останавливается и следует вопрос. В конце скилл пишет `quark_install_result.json` в рабочую папку и сверяет его со схемой. Запросы на отдельный PyTorch, настройку только ONNX Runtime и квантование он не берёт.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add amd/skills --skill quark-install -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/quark-install/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/quark-install/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add amd/skills --skill quark-install -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/quark-install/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add amd/skills --skill quark-install -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/quark-install/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install amd/skills quark-install
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/quark-install/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add amd/skills --skill quark-install -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/amd/skills --path skills/quark-install
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/quark-install/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add amd/skills --skill quark-install -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/amd/skills/tree/HEAD/skills/quark-install/SKILL.md

## Когда брать
- поставить AMD Quark в конкретное окружение Python
- проверить, что PyTorch совпадает с ускорителем
- разобраться с ModuleNotFoundError для quark
- починить ошибку компиляции ядер Quark
- выбрать между wheel с PyPI, нативным wheel и сборкой из исходников

## Примеры запросов агенту
- Установи Quark в активное окружение и проверь импорт
- Проверь, что PyTorch видит GPU, прежде чем ставить amd-quark
- Поставь Quark из локального wheel по этому пути

## Похожие
- [cuopt-install](https://affpapa.org/nevibecode/skills/cuopt-install.md) — скилл · 2500 установок
- [profile-model](https://affpapa.org/nevibecode/skills/profile-model.md) — скилл · 1200 установок
- [dali-dynamic-mode](https://affpapa.org/nevibecode/skills/dali-dynamic-mode.md) — скилл · 2100 установок
- [runpod-templates](https://affpapa.org/nevibecode/skills/runpod-templates.md) — скилл · 10100 установок
- [deep-learning](https://affpapa.org/nevibecode/skills/deep-learning.md) — скилл · 946 установок
- [vast-gpu](https://affpapa.org/nevibecode/skills/vast-gpu.md) — скилл · 453 установки

Из того же набора: [amd/skills](https://affpapa.org/nevibecode/by/amd/skills.md) — 10 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md