Skip to content

49M/identity-brand-engine

Repository files navigation

TrueU 🎯

AI-powered content creation that stays true to your voice.

TrueU helps content creators maintain authenticity while producing high-performing content. Define your brand identity across five dimensions, analyze videos for retention patterns and brand alignment, and get personalized content ideasβ€”all powered by advanced AI.

TypeScript Next.js License


🌟 What is TrueU?

TrueU solves the creator's challenge: staying authentic while growing your audience. Map your unique brand identity, analyze video content for performance insights, and generate ideas that align with your voice.

Core Features

  1. 5-Dimension Brand Identity - Define your voice across Tone, Authority, Depth, Emotion, and Risk
  2. Video Analysis with Twelve Labs - Upload videos to get retention timelines, brand alignment scores, and actionable feedback
  3. Viral Trend Analyzer - Discover trending content in your niche and get brand-aligned adaptations with web search
  4. Video Remix - Transform viral videos into scripts that match your authentic voice while maintaining viral potential
  5. AI Content Generation - Get personalized content ideas that match your brand
  6. Target Audience Insights - Understand who you're creating for
  7. Brand Coherence Tracking - Monitor how consistently your content aligns with your identity

✨ Key Features

🎨 5-Dimension Brand Identity

Define your authentic voice:

  • Tone: Aggressive to calm
  • Authority: Peer guide to expert educator
  • Depth: Tactical how-tos to philosophical concepts
  • Emotion: Analytical to inspirational
  • Risk: Safe to controversial

πŸ“Ή Video Analysis (Twelve Labs)

Upload videos to get:

  • Retention Timeline - Predicted engagement patterns with color-coded segments (green/yellow/red)
  • Brand Alignment Score - How well videos match your identity across all 5 dimensions
  • Actionable Feedback - Specific strengths and improvements with timestamps
  • Content Insights - Auto-generated titles, topics, hashtags, and summaries
  • Video Remix - Transform any video into a brand-aligned script ready to film

πŸ”₯ Viral Trend Analyzer

Real-time trend discovery with web search:

  • What's Trending - Current viral content in your niche with view counts and creators
  • Why It Works - Engagement psychology behind trending formats
  • Brand Adaptation - How to authentically adapt trends to your voice
  • Ready-to-Use Ideas - Specific video concepts combining trends with your identity

πŸ€– AI Content Generation

  • Chat interface for content brainstorming
  • Ideas tailored to your brand dimensions
  • Platform-specific recommendations
  • Powered by OpenAI GPT-4o and Claude 3.5 Sonnet

πŸ‘₯ Target Audience Insights

  • AI-generated audience profiles
  • Demographics, interests, and pain points
  • Platform optimization suggestions
  • Updates automatically with profile changes

πŸ“Š Brand Coherence Tracking

  • Dashboard score showing average brand alignment
  • Based on all uploaded video analyses
  • Dimension-level breakdowns
  • Empty state prompts for initial uploads

πŸ—οΈ Architecture

TrueU is built with modern web technologies and AI infrastructure:

Tech Stack

Frontend

  • Next.js 15.1 with App Router
  • TypeScript
  • Tailwind CSS
  • React Markdown

AI & Video Analysis

  • Twelve Labs (Marengo 3.0, Pegasus 1.2) - Video analysis
  • Grok-3 via X.AI - Brand alignment scoring
  • OpenAI GPT-4o - Content generation
  • Claude 3.5 Sonnet - Identity reasoning
  • Backboard.io - AI orchestration

Storage

  • JSON-based local storage
  • Profile, Brand, Content, Insights memory files

Architecture Highlights

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                    TrueU Platform                        β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚                                                           β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
β”‚  β”‚   Profile    β”‚  β”‚    Ideas     β”‚  β”‚   Insights   β”‚  β”‚
β”‚  β”‚   Creation   β”‚  β”‚ Generation   β”‚  β”‚   Analysis   β”‚  β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
β”‚         β”‚                  β”‚                  β”‚          β”‚
β”‚         β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜          β”‚
β”‚                         β”‚                                β”‚
β”‚                 β”Œβ”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”                       β”‚
β”‚                 β”‚  Memory System  β”‚                      β”‚
β”‚                 β”‚  (JSON Files)   β”‚                      β”‚
β”‚                 β””β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”˜                       β”‚
β”‚                         β”‚                                β”‚
β”‚         β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”               β”‚
β”‚         β”‚                               β”‚               β”‚
β”‚   β”Œβ”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”                  β”Œβ”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”         β”‚
β”‚   β”‚ Backboard β”‚                  β”‚   Local   β”‚         β”‚
β”‚   β”‚    AI     β”‚                  β”‚  Storage  β”‚         β”‚
β”‚   β”‚ Assistant β”‚                  β”‚           β”‚         β”‚
β”‚   β””β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜                  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜         β”‚
β”‚         β”‚                                                β”‚
β”‚   β”Œβ”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”                                         β”‚
β”‚   β”‚  OpenAI   β”‚                                         β”‚
β”‚   β”‚  Claude   β”‚                                         β”‚
β”‚   β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜                                         β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸš€ Getting Started

Prerequisites

  • Node.js 18+
  • npm or pnpm
  • API keys for:
    • Backboard.io
    • Twelve Labs
    • X.AI (for Grok-3)

Installation

  1. Clone the repository

    git clone https://github.com/yourusername/trueu.git
    cd trueu
  2. Install dependencies

    npm install
  3. Set up environment variables

    Create a .env.local file:

    BACKBOARD_API_KEY=your_key_here
    TWELVE_LABS_API_KEY=your_key_here
    XAI_API_KEY=your_key_here
  4. Run the development server

    npm run dev
  5. Open http://localhost:3000


πŸ“– Usage Guide

Creating Your Profile

  1. Click "Get Started" on the landing page
  2. Enter your name and content niche
  3. Adjust 5 brand dimension sliders
  4. Define your target audience
  5. Select your platforms
  6. AI generates your target audience profile

Analyzing Videos

  1. Click "Upload Video" from the dashboard
  2. Drag and drop or select a video file (up to 2GB)
  3. Wait for analysis (includes Twelve Labs processing + Grok-3 brand alignment)
  4. Review:
    • Retention timeline with color-coded engagement predictions
    • Brand alignment score with dimension breakdowns
    • Suggested title, topics, and hashtags
    • Actionable feedback with timestamps

Getting Content Ideas

  1. Click "Get Ideas" from dashboard
  2. Ask questions like:
    • "Give me 5 video ideas for this week"
    • "What's trending in my niche?"
    • "How can I improve my hook?"
  3. Review AI-generated suggestions tailored to your brand

Monitoring Brand Coherence

The dashboard shows your brand coherence score:

  • Average brand alignment across all uploaded videos
  • Dimension-level breakdowns
  • Updates automatically after each video upload

πŸ—‚οΈ Project Structure

trueu/
β”œβ”€β”€ app/
β”‚   β”œβ”€β”€ api/
β”‚   β”‚   β”œβ”€β”€ profile/           # Profile management
β”‚   β”‚   β”œβ”€β”€ video/             # Video upload & analysis
β”‚   β”‚   β”œβ”€β”€ brand-coherence/   # Brand scoring
β”‚   β”‚   β”œβ”€β”€ generate-content/  # Content ideas
β”‚   β”‚   └── update-identity/   # Identity updates
β”‚   β”œβ”€β”€ dashboard/
β”‚   β”‚   └── components/
β”‚   β”‚       β”œβ”€β”€ UploadVideoPanel.tsx
β”‚   β”‚       β”œβ”€β”€ GetIdeasPanel.tsx
β”‚   β”‚       └── EditIdentityPanel.tsx
β”‚   β”œβ”€β”€ create-profile/        # Onboarding
β”‚   └── page.tsx               # Landing
β”œβ”€β”€ lib/
β”‚   β”œβ”€β”€ ai/
β”‚   β”‚   β”œβ”€β”€ backboard-initialize.ts
β”‚   β”‚   β”œβ”€β”€ twelvelabs.ts
β”‚   β”‚   β”œβ”€β”€ retention-analyzer.ts
β”‚   β”‚   └── model-router.ts
β”‚   └── memory/
β”‚       β”œβ”€β”€ types.ts
β”‚       β”œβ”€β”€ read.ts
β”‚       └── write.ts
└── memory/                    # JSON storage (gitignored)

πŸ› οΈ Development

Available Scripts

# Development server
npm run dev

# Production build
npm run build

# Start production server
npm start

# Lint code
npm run lint

# Type check
npx tsc --noEmit

Adding New Features

  1. Memory Types - Define in lib/memory/types.ts
  2. API Routes - Create in app/api/[route]/route.ts
  3. Components - Add to app/dashboard/components/
  4. AI Functions - Extend lib/ai/backboard-initialize.ts

Environment Variables

Variable Description Required
BACKBOARD_API_KEY Backboard.io API key Yes
TWELVE_LABS_API_KEY Twelve Labs API key Yes
XAI_API_KEY X.AI API key for Grok-3 Yes

🎨 Design Philosophy

Core principles:

  1. Authenticity First - Never compromise the creator's voice
  2. Local-First Storage - Your data stays on your machine
  3. AI as Amplifier - Enhance human creativity
  4. Actionable Insights - Specific feedback, not generic advice

Design system: Pink-purple gradient brand, glassmorphism UI, responsive layout


πŸ”’ Privacy & Data

  • All profile data stored locally as JSON files
  • No cloud sync - data stays on your machine
  • API calls only for AI processing (Backboard.io, Twelve Labs, X.AI)
  • No analytics or user tracking

🚧 Roadmap

Current (v1.0)

  • βœ… 5-dimension brand identity
  • βœ… Video upload & analysis with Twelve Labs
  • βœ… Retention timeline predictions
  • βœ… Brand alignment scoring with Grok-3
  • βœ… Video remix feature (maintain virality while staying on-brand)
  • βœ… Viral trend analyzer with web search
  • βœ… AI content ideas generation
  • βœ… Target audience insights
  • βœ… Brand coherence tracking

Next

  • Social profile content analysis
  • Content performance tracking
  • Multi-profile support
  • Competitor insights
  • Content calendar generation

🀝 Contributing

Contributions welcome:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/NewFeature)
  3. Commit your changes
  4. Open a Pull Request

Guidelines: Follow TypeScript best practices, write meaningful commits, ensure npm run lint passes


πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


πŸ™ Acknowledgments

  • Backboard.io - AI orchestration
  • Twelve Labs - Video analysis
  • X.AI - Grok-3 model
  • OpenAI - GPT-4o
  • Anthropic - Claude 3.5 Sonnet
  • Vercel - Deployment

If you find TrueU helpful, please consider giving it a star ⭐


Built with ❀️ by creators, for creators

Be TrueU. Be Authentic.

About

TrueU solves the creator's challenge: staying authentic while growing your audience. Map your unique brand identity, analyze video content for performance insights, and generate ideas that align with your voice.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages