youtubepro README

The project's README from github.com/AgriciDaniel/youtubepro. As one markdown file: README.md.

YouTube Pro logo

YouTube Pro

Research, understand, write, and package a YouTube video in one local-first workflow.

YouTube Pro is an evidence-grounded workspace for YouTube research, idea selection, script writing, and thumbnail creation. It combines public YouTube Data API v3 records with Gemini analysis while keeping API keys on the server.

YouTube Pro is an independent project. It is not affiliated with, endorsed by, or sponsored by YouTube or Google. YouTube and Google product names are trademarks of their respective owners.

Product tour

Research analytics

Search a topic, inspect the returned public-data snapshot, compare momentum and publication patterns, review data coverage, and continue into AI-assisted insights and ideas.

YouTube Pro research analytics with video performance, momentum, duration, and publication graphs

Source videos

Review every video included in the active public-data snapshot, with thumbnails, channel information, views, publication timing, likes, and comments visible in one grid.

YouTube Pro source-video grid showing every video used in the research snapshot

AI Insights

Turn the active snapshot into a scan-first research brief with audience questions, opportunity themes, recommended moves, and a clear separation between observed evidence, inference, and metrics that require YouTube Studio.

YouTube Pro AI Insights with visual summaries, evidence balance, and an expandable evidence ledger

Script teleprompter

Turn a selected idea into an editable script, then read it in a focused teleprompter with pace, size, cue, undo, and playback controls.

YouTube Pro teleprompter with playback and reading controls

Thumbnail Creator

Describe the outcome once, add optional references or advanced controls, generate a readable 16:9 thumbnail, and create variations from the same workflow.

YouTube Pro Thumbnail Creator with a generated thumbnail preview and minimal creation controls

These screenshots come from a live local development build using public YouTube metadata. They are not generated interface mockups.

Workflow

The product follows one continuous workflow:

  1. Research: Search up to 50 public YouTube videos, review the overview, analytics, coverage, and every returned video.
  2. AI Insights: Gemini analyzes the exact active research snapshot. Claims retain their snapshot identity and source video IDs, or are explicitly labeled as aggregate inference or as requiring YouTube Studio.
  3. Grounded Ideas: Ideas generate automatically after valid Insights. Select one idea, then explicitly proceed to Script Writer.
  4. Script Writer: Generate and edit a script from the selected idea package and its evidence. Section and paragraph regeneration use the same bounded evidence context.
  5. Thumbnail Creator: Use the selected promise and thumbnail concept, outcome-oriented presets, editable controls, and up to three permitted references.

There is no standalone Ideas screen. The legacy /ideas path redirects to the Ideas section inside Research.

Each press of New Workflow creates a separate local project. The sidebar keeps the eight most recent workflows in browser IndexedDB, lets the user rename or delete them, and reopens the last active Research, Script, or Thumbnail step. Research snapshots, generated ideas, editable scripts, thumbnail briefs, and generated thumbnail results are restored together. Uploaded reference images are intentionally not retained, so permission and file selection are fresh for every later generation.

Requirements

Copy the example configuration and fill it locally:

cp .env.example .env
npm install
npm run dev

The server listens on 127.0.0.1:5000 by default. Open http://127.0.0.1:5000.

You can instead start without keys and enter them in Settings. Settings writes replacements to the ignored .env file with owner-only permissions. Saved values are never returned to the browser. Settings accepts direct loopback, same-origin requests only and rejects normal forwarded or reverse-proxy requests.

Configuration

Variable Purpose Default
YOUTUBE_API_KEY YouTube Data API v3 search and enrichment Required for Research
GEMINI_API_KEY Gemini text and image generation Required for AI features
GEMINI_TEXT_MODEL Research, Ideas, Script, and regeneration model gemini-3.7-flash
GEMINI_IMAGE_MODEL Thumbnail generation model gemini-3.1-flash-image
PORT Local HTTP port 5000
HOST Bind address 127.0.0.1

The Settings page exposes the server allowlist and its current descriptions. Models are not hardcoded by the client. Changing the allowlist in server/gemini-models.ts changes the available Settings options.

Data and request limits

Privacy and access model

Gemini image outputs include Google's invisible SynthID provenance. The application does not add a visible watermark and does not claim SynthID can be disabled.

Commands

npm run dev       # development server
npm test          # contract and provider-behavior tests
npm run check     # TypeScript check
npm run build     # production client and server build
npm start         # run the production build

Continuous integration runs the test suite, TypeScript check, and production build on every pull request and push to main.

Technology

Quotas and costs

YouTube search is quota-expensive compared with video and channel enrichment. Gemini limits and pricing vary by model and account. Check the current official documentation before changing models or making the server remotely accessible:

License

YouTube Pro is open source under the Apache License 2.0.

Contributing and security

See CONTRIBUTING.md for the local quality gate. Report security issues privately according to SECURITY.md, never in a public issue.

youtubepro (AgriciDaniel/youtubepro)

Searching Database…

421 ·GitHub
Youtubepro
Что это?YouTube Pro — рабочее пространство в духе local-first, объединяющее публичные данные YouTube Data API v3 с анализом Gemini AI, чтобы помогать исследовать темы, получать обоснованные идеи для контента, писать сценарии и генерировать превью для видео на YouTube.
Это хостинг-веб-приложение или то, что я запускаю локально сам?Это self-hosted сервер на Node.js/Express с фронтендом на React, который вы запускаете на своей машине; по умолчанию он привязывается только к localhost и не предлагается как облачный SaaS.
Как его запустить?Нужен Node.js 22.12 или новее; затем скопируйте пример файла конфигурации локально и впишите свои ключи (или оставьте пустыми и добавьте позже в Settings) перед запуском сервера, который слушает 127.0.0.1:5000.
Нужны ли свои API-ключи YouTube и Gemini?Да, ключ YouTube Data API v3 нужен для Research, а ключ Gemini API — для Insights, Ideas, Script Writer и Thumbnail Creator; можно начать без ключей и ввести их позже в Settings.
Есть ли ограничения на использование, о которых стоит знать?Поиск в Research ограничен 50 видео и запросами до 200 символов, для превью можно указать не более трёх изображений до 5 МБ каждое, а тарифицируемые маршруты YouTube/Gemini ограничены 10 запросами на клиента за 60 секунд, так как это однопроцессный локальный сервер.
Куда на самом деле уходят мои данные и API-ключи?API-ключи записываются на стороне сервера в игнорируемый git'ом файл .env с правами только для владельца и никогда не возвращаются в браузер; история недавних воркфлоу хранится только в IndexedDB вашего браузера, а тела запросов/ответов никогда не логируются.
Как на самом деле устроен процесс от исследования до превью?Вы ищете до 50 публичных видео, Gemini превращает этот точный снимок в бриф Insights, из валидных Insights генерируются Grounded Ideas, одна идея становится редактируемым сценарием (Script), а та же выбранная идея и доказательства поступают в Thumbnail Creator. Каждый клик на 'New Workflow' начинает свежий локальный проект, который хранится в недавней истории в боковой панели.
Почему self-hosted, а не облачная SaaS-версия?Локальность всего означает, что API-ключи и история никогда не покидают вашу машину; страница Settings принимает только прямые loopback-запросы, а README явно предупреждает не выставлять сервер в интернет без собственной аутентификации и ограничения частоты запросов.
Не выдумывает ли ИИ факты о моих видео?Нет, Gemini Insights ограничены точным активным снимком исследования, и каждое утверждение помечено как наблюдаемое доказательство, агрегированный вывод или то, что требует подтверждения в YouTube Studio, так что спекулятивные утверждения явно отделены от фактов.
Есть ли на сгенерированных превью водяной знак?Сгенерированные Gemini изображения содержат невидимую метку происхождения SynthID от Google; приложение не добавляет видимого водяного знака и не утверждает, что SynthID можно отключить.
What are similar projects?printfilm, ace-step-ui, gpt_image_playground, waoowaoo, moyin-creator, rankme.fast, empire, OpenStock
Which topics is it in?shadcn-ui, express, youtube, content-creation, tailwindcss, vite, image-generation, gemini, generative-ai, local-first, web-app, research
Creator
AgriciDaniel
Size
3.9 MB
Stars
421
Updated
CommitAug 27Releasev1.0.0Aug 24
Age
1mo
Commits · 90 Days