Update README.md

README.md

@@ -16,83 +16,132 @@ Developed by **Inner I Breathfield Productions**
 
 The Inner I YT Genre Architect is an AI-powered tool that analyzes YouTube channel metadata and automatically generates intelligent playlist structures. It helps creators organize their content ecosystems to improve viewer navigation, session duration, and channel discoverability.
 
-Optional OAuth integration allows playlists to be published directly to a creator’s YouTube account while preserving watch time attribution and monetization ownership.
-
 Official Tool Hub  
 https://innerinetcompany.com/2026/02/13/yt-genre-architect
 
+---
+Inner I — YT Genre Architect analyzes public YouTube metadata and automatically clusters videos into intelligently named genre playlists.
+
+Paste a channel link → scan → cluster → export playlists.
+
+No downloads. No reuploads. No scraping private data.
+
+---
+
+## What This Tool Does
+
+- Analyzes public YouTube titles + descriptions
+- Uses AI embeddings (SentenceTransformers)
+- Clusters videos into genre-style buckets
+- Generates readable playlist names
+- Exports:
+  - JSON
+  - CSV
+
+Designed for creators, curators, music channels, and long-form content organizers.
+
+---
+
+## How It Works
+
+1. Enter a YouTube channel URL or handle  
+2. Choose how many videos to scan  
+3. Choose how many playlists to generate  
+4. Click **Generate**  
+5. Export your structured playlists  
+
+The clustering model uses semantic embeddings to group similar themes and styles together.
+
 ---
 
-# What This Space Does
+## Requirements
 
-- Scans public YouTube channel metadata  
-- Clusters videos by theme/style  
-- Generates optimized playlist titles  
-- Builds playlist descriptions  
-- Exports structured playlist data  
-- Publishes playlists to YouTube (optional)
+You must provide a YouTube Data API key.
 
-No video content is copied or hosted.
+Add it in **HF Space Settings → Secrets**: YOUTUBE_API_KEY=your_key_here
+
+Go get your API key here:
+
+https://console.cloud.google.com/
 
 ---
 
-# Creator Earnings Integrity
+## What This Tool Does NOT Do
+
+- It does not download videos
+- It does not rehost content
+- It does not access private data
+- It does not bypass YouTube restrictions
+- It does not guarantee algorithm growth
+
+It works only with publicly available metadata via official APIs.
 
-When playlists are pushed through OAuth:
+---
 
-- Playlists are created inside the creator’s account  
-- Views remain attributed to the creator  
-- Watch time is not redirected  
-- Monetization impact stays with the channel owner  
+## Technology Stack
 
-This design ensures tooling enhances creator infrastructure without diverting value.
+- Gradio
+- SentenceTransformers
+- scikit-learn (KMeans clustering)
+- YouTube Data API v3
+- Hugging Face Spaces
 
 ---
 
-# Technology Stack
+## Who Is This For?
+
+- Music artists organizing discographies
+- Podcast channels grouping episodes
+- Education channels structuring lessons
+- Content strategists planning watch-time funnels
+- Indie creators wanting structured archives
+
+---
 
-- YouTube Data API
-- Semantic clustering
-- Keyword extraction
-- OAuth authorization
-- Stripe subscription controls
-- Gradio UI
+## Performance Notes
 
-All processing operates on public data or explicit user authorization.
+- The first run loads the embedding model (cold start).
+- Larger scans (200–300 videos) require more processing time.
+- If hardware is upgraded, higher scan limits are safe.
 
 ---
 
-# Required HF Secrets
+## Legal & Compliance
 
-Add these under **Space Settings → Secrets**
+This application complies with:
 
-## YouTube Scanning
+- YouTube API Terms of Service  
+- Google API Services User Data Policy  
 
-YOUTUBE_API_KEY
-APP_SECRET
+See `TERMS_PRIVACY.md` for full Terms of Service and Privacy Policy.
 
-## OAuth Playlist Publishing
+---
+
+## About Inner I
 
-GOOGLE_OAUTH_CLIENT_ID
-GOOGLE_OAUTH_CLIENT_SECRET
-GOOGLE_OAUTH_REDIRECT_URL
+Inner I builds tools that support:
 
-## Subscription Paywall
+- Creator sovereignty  
+- Structured digital presence  
+- Conscious technology deployment  
+- Scalable creative workflows  
 
-STRIPE_SECRET_KEY
-STRIPE_WEBHOOK_SECRET
-STRIPE_PRICE_ID_STARTER
-STRIPE_PRICE_ID_CREATOR
-STRIPE_PRICE_ID_PRO
+Website:  
+https://innerinetcompany.com
+
+---
 
-# Tier Model
+## Roadmap (Optional Future Features)
+
+- Direct playlist push via OAuth  
+- Watch-time flow analytics  
+- Semantic genre labeling presets  
+- Batch channel comparison  
+- Creator revenue funnel mapping  
+
+---
 
-| Tier    | Videos | Playlists | Push | Scans  |
-| ------- | ------ | --------- | ---- | ------ |
-| Free    | 20     | 3         | No   | 1/day  |
-| Starter | 60     | 6         | No   | 1/day  |
-| Creator | 150    | 10        | Yes  | 10/day |
-| Pro     | 300    | 16        | Yes  | 50/day |
+### Built on Hugging Face Spaces
 
 Legal & Privacy