# Установка для ИИ-агента

## Требования

- Python 3.10+
- Node.js 22+
- FFmpeg 6+
- 7-Zip или unrar для RAR
- 4–8 ГБ свободного места на проект

Проверка:

```bash
python --version
node --version
ffmpeg -version
ffprobe -version
```

## Python

```bash
python -m venv .venv
# Windows
.venv\Scripts\activate
# Linux/macOS
source .venv/bin/activate
pip install -r requirements.txt
pip install -r requirements-optional.txt
```

Для настоящих временных меток слов нужен `faster-whisper`. На слабом компьютере начни с модели `base`, на нормальном — `small`, на мощном — `medium`. Для русской речи не используй англоязычные модели `.en`.

## HyperFrames

```bash
npm install -g hyperframes
npx skills add heygen-com/hyperframes
hyperframes doctor
```

Если агент поддерживает навыки, используй:

- `/hyperframes`
- `/hyperframes-cli`
- `/hyperframes-media`
- `/hyperframes-registry`
- `/gsap`
- `/animejs`
- `/css-animations`
- `/lottie`
- `/three`
- `/waapi`

Дополнительные навыки по задаче:

- `website-to-hyperframes`
- `remotion-to-hyperframes`

Установщики находятся в `scripts/install_official_hyperframes_skills.*`.

## Обязательная проверка перед проектом

```bash
hyperframes doctor
python scripts/environment_doctor.py
```

## Безопасность

- Скопируй `.env.example` в `.env`.
- Не записывай ключи в `*.txt`, JSON проекта, журналы и архив результата.
- Не прикладывай файлы шрифтов.
- Стоковые материалы сохраняй с автором, источником и лицензией.