| --- |
| license: other |
| license_name: proprietary |
| license_link: LICENSE |
| language: |
| - ru |
| tags: |
| - youtube |
| - analytics |
| - desktop |
| - windows |
| - comments |
| pipeline_tag: text-classification |
| --- |
| |
| <div align="center"> |
|
|
| # YouTube Intel Desktop |
|
|
| ### Профессиональная Windows-сборка для анализа комментариев YouTube |
|
|
|  |
|  |
|  |
|  |
|  |
|
|
| **Готовое локальное приложение для Windows, которое запускает аналитический интерфейс в браузере без Python, Docker и ручной серверной настройки.** |
|
|
| </div> |
|
|
| --- |
| ## Быстрый Гайд |
|
|
| **Сделал на скорую руку, чтобы вы быстро разобрались** |
|
|
| <video width="100%" controls> |
| <source src="https://huggingface.co/herman3996/YouTubeIntelDesktop/resolve/main/media/guide.mp4" type="video/mp4"> |
| </video> |
|
|
| --- |
|
|
|
|
| ## Что находится в этом репозитории |
|
|
| Этот репозиторий подготовлен как **готовая поставка для клиента через 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) Поддержка и разрешение на использование |
|
|
| Если вам нужно: |
| - подтвердить право использования; |
| - передать приложение внутри компании; |
| - согласовать коммерческое применение; |
| - получить новую сборку; |
| - запросить обновление или отдельное разрешение, |
|
|
| обращайтесь **к автору / правообладателю, от которого вы получили эту поставку**. |
|
|
| --- |
|
|
| <div align="center"> |
|
|
| **YouTube Intel Desktop** — локальный аналитический инструмент для профессиональной работы с комментариями YouTube. |
|
|
| </div> |
|
|
