shaheerabbas/aurelia-video-seo-studio

Aurelia Video SEO Studio

A premium Streamlit workspace that turns a YouTube URL into SEO recommendations, publish-ready metadata, and HD thumbnail directions.

Space Configuration

This app is prepared for a Hugging Face Docker Space, which is the current recommended route for Streamlit apps.

In the Space Settings page, add these repository secrets:

Do not upload a local .env file or paste secret values into committed source files.

Deploy On Hugging Face

1. 1.Create a new Hugging Face Space and choose Docker with the Streamlit template.
2. 2.Clone the new Space repository locally, or upload the files in this folder through the Files tab.
3. 3.Add GROQ_API_KEY and HF_TOKEN under Settings > Variables and secrets > Secrets.
4. 4.Commit and push the project files. The Space builds the Docker image and starts the app automatically.

The container exposes port 7860, which is configured in both this Space metadata and the Dockerfile.

The app uses yt-dlp to retrieve public YouTube metadata without requiring a Google Cloud API key. YouTube can still withhold statistics for an individual hosted request, in which case the strategy tools remain available.

For hosted YouTube restrictions, the Docker image also runs the bgutil-ytdlp-pot-provider integration recommended by the yt-dlp PO Token guide. This is intended to improve metadata retrieval from cloud-hosted IP addresses, though YouTube may still restrict individual requests.

Run Locally

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\python.exe -m streamlit run app.py

For local development, define credentials in .env or enter them temporarily in the sidebar. The .env file is excluded from deployment.