# YouTube Intel Desktop
### Профессиональная Windows-сборка для анализа комментариев YouTube
**Готовое локальное приложение для Windows, которое запускает аналитический интерфейс в браузере без Python, Docker и ручной серверной настройки.**
---
## Быстрый Гайд
**Сделал на скорую руку, чтобы вы быстро разобрались**
---
## Что находится в этом репозитории
Этот репозиторий подготовлен как **готовая поставка для клиента через Hugging Face**.
Внутри находятся:
- `YouTubeIntelDesktop.zip` — архив с готовой desktop-версией;
- `README.md` — подробная инструкция по скачиванию, запуску и настройке;
- `LICENSE` — ограничительная лицензия на использование.
> **Важно:** это **не open-source релиз**. Публикация на Hugging Face используется только как удобный способ передачи файла. Право использования определяется отдельным разрешением правообладателя и файлом [`LICENSE`](./LICENSE).
---
## Быстрый старт — версия на 5 минут
| Шаг | Что сделать | Что получится |
|---|---|---|
| 1 | Скачать `YouTubeIntelDesktop.zip` | Получите архив с приложением |
| 2 | Распаковать архив в обычную папку | Появится папка `YouTubeIntelDesktop` |
| 3 | Запустить `YouTubeIntelDesktop.exe` | Приложение поднимет локальный сервис |
| 4 | Вставить OpenAI API key и YouTube API key | Аналитика станет доступна |
| 5 | Вставить ссылку на видео YouTube и нажать запуск | Получите готовый аналитический результат |
Если хотите пройти всё спокойно, без лишних догадок и ошибок — ниже есть **полная пошаговая инструкция**.
---
## 1) Как скачать приложение с Hugging Face
### Самый простой способ
Нажмите на прямую ссылку:
**[Скачать `YouTubeIntelDesktop.zip`](https://huggingface.co/herman3996/YouTubeIntelDesktop/resolve/main/YouTubeIntelDesktop.zip)**
### Если хотите скачать через интерфейс Hugging Face
1. Откройте вкладку **Files and versions** в этом репозитории.
2. Найдите файл **`YouTubeIntelDesktop.zip`**.
3. Справа от имени файла нажмите на **иконку скачивания** (стрелка вниз / download).
4. Дождитесь завершения загрузки.
Официальная документация Hugging Face по загрузке файлов:
- https://huggingface.co/docs/huggingface_hub/main/en/guides/download
> **Важно:** для обычного пользователя **не нужен Git, Python или командная строка**. Достаточно скачать ZIP-файл и распаковать его.
---
## 2) Как правильно распаковать архив
1. Найдите скачанный файл **`YouTubeIntelDesktop.zip`** в папке «Загрузки».
2. Нажмите по нему **правой кнопкой мыши**.
3. Выберите **«Извлечь всё...» / “Extract All...”**.
4. Укажите обычную папку, например:
- `Рабочий стол\YouTubeIntelDesktop`
- или `Документы\YouTubeIntelDesktop`
5. После распаковки откройте папку **`YouTubeIntelDesktop`**.
> **Важно:** не запускайте приложение прямо из ZIP-архива. Сначала обязательно распакуйте архив полностью.
---
## 3) Как запустить приложение
После распаковки:
1. Откройте папку **`YouTubeIntelDesktop`**.
2. Дважды щёлкните по файлу **`YouTubeIntelDesktop.exe`**.
3. Приложение запустит локальный сервис.
4. После этого автоматически откроется интерфейс в браузере.
### Если браузер не открылся автоматически
Откройте вручную:
**http://127.0.0.1:8765/ui**
### Если Windows показывает предупреждение SmartScreen
Это возможно для неподписанных desktop-сборок.
Если архив получен **напрямую от автора / с его разрешения**, можно сделать так:
1. Нажмите **More info / Подробнее**.
2. Затем нажмите **Run anyway / Выполнить в любом случае**.
> Во время работы приложения может быть открыто консольное окно Windows. **Не закрывайте его**, пока используете программу: это локальный служебный процесс.
---
## 4) Что понадобится перед первым анализом
Подготовьте:
- **Windows 10 или Windows 11**;
- стабильный интернет;
- **OpenAI API key**;
- **YouTube Data API v3 key**;
- **YouTube Playlist ID**;
- несколько гигабайт свободного места для локальной базы, кэша и отчётов.
> В приложении рекомендуется сразу заполнить **YouTube Playlist ID**. Проще всего открыть любое видео внутри нужного плейлиста YouTube, найти в ссылке параметр `list=` и скопировать значение после него.
---
## 5) Где получить OpenAI API key
Приложение использует OpenAI для части интеллектуальной аналитики и формирования итоговых структурированных выводов.
### Пошагово
1. Войдите в OpenAI Platform:
https://platform.openai.com/
2. Откройте страницу API-ключей:
https://platform.openai.com/api-keys
3. Нажмите **Create new secret key**.
4. Скопируйте сгенерированный ключ.
5. Вставьте его в приложение в поле **OpenAI API key**.
### Официальные материалы OpenAI
- Где найти API key:
https://help.openai.com/en/articles/4936850-where-do-i-find-my-openai-api-key
- Quickstart:
https://platform.openai.com/docs/quickstart
- Рекомендации по безопасности API-ключей:
https://help.openai.com/en/articles/5112595-best-practices-for-api-key-safety
### Важно про оплату OpenAI
API OpenAI оплачивается **отдельно** от подписки ChatGPT.
Официальные материалы:
- API и ChatGPT billing управляются отдельно:
https://help.openai.com/en/articles/8156019-i-want-to-move-my-chatgpt-subscription-to-the-api
- Страница billing в OpenAI Platform:
https://platform.openai.com/settings/organization/billing/overview
> Проще говоря: даже если у вас есть ChatGPT Plus, это **не означает**, что API уже настроен. Для приложения нужен именно **API key** и, при необходимости, активированный billing для API.
---
## 6) Где получить YouTube Data API v3 key
Приложение использует **YouTube Data API v3** для загрузки видео, комментариев и служебных метаданных.
### Пошагово
1. Войдите в Google-аккаунт.
2. Откройте обзор YouTube Data API v3:
https://developers.google.com/youtube/v3/getting-started
3. Включите API в Google Cloud Console:
https://console.cloud.google.com/apis/library/youtube.googleapis.com
4. Затем откройте страницу Credentials:
https://console.cloud.google.com/apis/credentials
5. Нажмите **Create credentials** → **API key**.
6. Скопируйте созданный ключ.
7. Вставьте его в приложение в поле **YouTube API key**.
### Официальные материалы Google
- Обзор YouTube Data API v3:
https://developers.google.com/youtube/v3/getting-started
- Как зарегистрировать приложение и получить credentials:
https://developers.google.com/youtube/registering_an_application
### Практический совет
После создания ключа желательно ограничить его в Google Cloud Console:
- по нужному API (**YouTube Data API v3**);
- при необходимости — по среде использования.
Согласно официальной документации Google, проекты с включённым YouTube Data API v3 обычно получают **квоту 10,000 units per day по умолчанию**, чего достаточно для большинства базовых сценариев.
---
## 7) Что такое YouTube Playlist ID и как его найти
**YouTube Playlist ID нужно указывать в приложении обязательно.**
Это идентификатор плейлиста YouTube, который приложение использует в настройках и сценариях запуска. Поэтому лучше заполнить его сразу при первом запуске вместе с API-ключами.
### Как его найти быстрее всего
Самый простой способ:
1. Откройте любое видео внутри нужного плейлиста YouTube.
2. Посмотрите на адресную строку браузера.
3. Найдите параметр `list=`.
4. Скопируйте значение после `list=` — это и есть **YouTube Playlist ID**.
### Как его найти
Самый простой способ:
1. Откройте нужный плейлист YouTube в браузере.
2. Посмотрите на адресную строку.
3. Найдите параметр `list=`.
4. Значение после `list=` — это и есть **Playlist ID**.
Пример:
- `https://www.youtube.com/playlist?list=PLxxxxxxxxxxxx`
- здесь `PLxxxxxxxxxxxx` — это Playlist ID.
Пример с видео из плейлиста:
- `https://www.youtube.com/watch?v=X7N00ULAiH0&list=PLN4JaHJl48UbdnB0GONLpH953hc8MqtOG`
- здесь `PLN4JaHJl48UbdnB0GONLpH953hc8MqtOG` — это Playlist ID, потому что он стоит после `list=`.
То есть вам не обязательно открывать страницу самого плейлиста. Достаточно открыть **любое видео** из подходящего плейлиста и скопировать всё, что стоит после `list=`.
Если речь идёт именно о плейлисте загрузок канала, YouTube API хранит его как `contentDetails.relatedPlaylists.uploads`. Официальная документация:
- https://developers.google.com/youtube/v3/docs/channels
> Если кнопка анализа последнего видео не работает или приложение просит дополнительные настройки, первым делом проверьте, что **YouTube Playlist ID** заполнен правильно.
---
## 8) Что вводить при первом запуске
При первом запуске приложение попросит основные данные.
### Обязательные поля
- **OpenAI API key**
- **YouTube API key**
### Обязательное поле
- **YouTube Playlist ID**
### Что лучше оставить по умолчанию
Для первого знакомства обычно лучше:
- оставить **Embedding mode = `local`**;
- не менять остальные настройки без необходимости.
Почему так проще:
- меньше риск ошибиться;
- проще проверить базовую работоспособность;
- все важные параметры можно изменить позже через интерфейс.
---
## 9) Как пользоваться приложением после запуска
### Самый простой сценарий первого теста
1. Запустите приложение.
2. Откройте страницу запуска анализа.
3. Вставьте ссылку вида:
- `https://www.youtube.com/watch?v=...`
4. Нажмите кнопку запуска.
5. Дождитесь завершения обработки.
6. Откройте отчёт.
### Что умеет приложение
Приложение предназначено не просто для выгрузки комментариев, а для **аналитической обработки**:
- тематическая группировка комментариев;
- выделение ключевых тем и позиций аудитории;
- классификация обращений к автору;
- отделение конструктивных, токсичных и вопросительных комментариев;
- формирование итоговых аналитических выводов;
- хранение истории запусков и результатов локально на компьютере.
---
## 10) Какие результаты вы получите
В зависимости от сценария использования приложение позволяет получать:
- **структурированный аналитический отчёт** по обсуждению видео;
- **картины тем и позиций аудитории**;
- **аналитику обращений к автору**: вопросы, критика, просьбы, токсичность;
- **локально сохранённые отчёты** и историю запусков;
- **контроль расхода OpenAI** внутри интерфейса.
Это делает сборку удобной для:
- автора канала;
- аналитика контента;
- редакционной команды;
- продюсерской и исследовательской работы.
---
## 11) Где приложение хранит данные на компьютере
На Windows локальные файлы приложения обычно находятся здесь:
`%LOCALAPPDATA%\YouTubeIntelDesktop\`
### Основные папки и файлы
| Путь | Назначение |
|---|---|
| `config\desktop.env` | рабочие настройки приложения |
| `config\secrets.json` | локально сохранённые секреты; на Windows защищаются средствами DPAPI |
| `data\youtube_intel.db` | локальная база SQLite |
| `data\reports\` | экспортированные отчёты |
| `data\cache\` | кэш и служебные данные |
| `data\raw\` | сырые снапшоты данных |
> Для обычного пользователя это значит следующее: приложение хранит результаты **локально на вашем компьютере**, а не требует отдельного сервера.
---
## 12) Что важно знать про безопасность ключей
- Не отправляйте свои API-ключи посторонним.
- Не публикуйте ключи в скриншотах и публичных репозиториях.
- Если есть подозрение на утечку — перевыпустите ключ.
Официальные материалы:
- OpenAI key safety: https://help.openai.com/en/articles/5112595-best-practices-for-api-key-safety
- Google credentials guide: https://developers.google.com/youtube/registering_an_application
---
## 13) Типичные вопросы и решения
### Браузер не открылся автоматически
Откройте вручную:
**http://127.0.0.1:8765/ui**
---
### Приложение не запускается после двойного клика
Проверьте:
1. архив точно распакован полностью;
2. вы запускаете `.exe` не из ZIP-файла;
3. Windows не заблокировала запуск через SmartScreen;
4. компьютер подключён к интернету.
---
### Ошибка OpenAI
Чаще всего причина одна из трёх:
- ключ введён с ошибкой;
- billing для API ещё не настроен;
- на аккаунте действуют лимиты.
Проверьте:
- https://platform.openai.com/api-keys
- https://platform.openai.com/settings/organization/billing/overview
---
### Ошибка YouTube API
Проверьте:
- включён ли **YouTube Data API v3**;
- создан ли именно **API key**;
- не заблокирован ли ключ ограничениями;
- правильно ли ключ вставлен в приложение.
Официальные ссылки:
- https://developers.google.com/youtube/v3/getting-started
- https://developers.google.com/youtube/registering_an_application
---
### Кнопка анализа последнего видео не работает
Скорее всего, не заполнен **YouTube Playlist ID** или он введён не полностью.
Откройте любое видео в нужном плейлисте, найдите в ссылке параметр `list=` и вставьте значение после него в поле **YouTube Playlist ID**.
---
### Первый запуск идёт медленно
Это нормально. При первом использовании приложению может потребоваться больше времени на локальную инициализацию, кэш и подготовку рабочих компонентов.
---
## 14) Рекомендуемый сценарий первого знакомства
Если вы используете подобный инструмент впервые, оптимальный порядок такой:
1. Скачать архив.
2. Распаковать его.
3. Запустить `YouTubeIntelDesktop.exe`.
4. Ввести **OpenAI API key**.
5. Ввести **YouTube API key**.
6. Сразу заполнить **YouTube Playlist ID**.
7. Если у вас есть только ссылка на видео из плейлиста, скопировать значение после `list=`.
8. Вставить ссылку на одно конкретное видео YouTube.
9. Запустить анализ.
10. Посмотреть итоговый отчёт.
Так вы быстрее всего проверите, что поставка работает корректно.
---
## 15) Лицензия и права использования
Использование регулируется файлом **[`LICENSE`](./LICENSE)**.
Кратко:
- приложение **не передаётся в свободное пользование**;
- использовать его могут **только лица, которым правообладатель дал личное письменное согласие**;
- **перепродажа, распространение, публикация, передача третьим лицам, модификация и иное использование без разрешения запрещены**.
> Сам факт доступа к файлу через Hugging Face **не означает**, что пользователь автоматически получил право на использование.
---
## 16) Поддержка и разрешение на использование
Если вам нужно:
- подтвердить право использования;
- передать приложение внутри компании;
- согласовать коммерческое применение;
- получить новую сборку;
- запросить обновление или отдельное разрешение,
обращайтесь **к автору / правообладателю, от которого вы получили эту поставку**.
---
**YouTube Intel Desktop** — локальный аналитический инструмент для профессиональной работы с комментариями YouTube.