Vibe Check - AI Video Analyzer

AI-powered short-form video analyzer for creators. Get performance predictions, quality feedback, and monetization strategies using Groq API.

Features

• Upload videos or paste TikTok/Instagram/YouTube links
• Real AI analysis powered by Groq
• Performance scoring (0-100)
• Virality predictions (low/medium/high)
• Quality breakdown (hook, pacing, visuals, audio, CTA)
• Actionable improvement suggestions
• Monetization strategy recommendations

Tech Stack

Frontend:

• Next.js 15 with App Router
• React 19 + TypeScript
• Tailwind CSS v4
• Lucide React icons

Backend:

• NestJS with Express
• PostgreSQL database
• FFmpeg for video analysis
• Groq API for AI
• Swagger/OpenAPI docs

Getting Started

Frontend

cd apps/frontend
npm install
npm run dev
# Open http://localhost:3000

Backend

cd apps/backend
npm install
# Setup .env with DB credentials and GROQ_API_KEY
npm run start:dev
# API runs on http://localhost:3001
# Swagger docs at http://localhost:3001/api/docs

API Endpoints

• POST /api/v1/analysis/upload - Analyze uploaded video
• POST /api/v1/analysis/link - Analyze video from URL
• POST /api/v1/analysis/health - Health check

Environment Variables

Backend (.env):

DB_USER=postgres DB_PASSWORD=postgres DB_HOST=localhost DB_PORT=5432 DB_NAME=vibe_check GROQ_API_KEY=your_groq_key NODE_ENV=development PORT=3001

Frontend (.env.local):

NEXT_PUBLIC_API_URL=http://localhost:3001

Database Setup

CREATE TABLE users (
  id VARCHAR(36) PRIMARY KEY,
  email VARCHAR(255) UNIQUE NOT NULL,
  created_at TIMESTAMP DEFAULT NOW(),
  updated_at TIMESTAMP DEFAULT NOW()
);

CREATE TABLE analyses (
  id VARCHAR(36) PRIMARY KEY,
  user_id VARCHAR(36) NOT NULL REFERENCES users(id),
  video_path VARCHAR(500),
  performance_score INTEGER,
  viraly_prediction VARCHAR(20),
  confidence INTEGER,
  quality_breakdown JSONB,
  hook_analysis TEXT,
  pacing_feedback TEXT,
  improvements JSONB,
  monetization_strategies JSONB,
  created_at TIMESTAMP DEFAULT NOW(),
  updated_at TIMESTAMP DEFAULT NOW()
);

Author

Built by Iram Bashir | [LinkedIn] | [GitHub]

---