Skip to content

spymanian/Showrunner

Repository files navigation

Showrunner

Showrunner Logo

🚀 Live Demo: https://showrunner-beta.vercel.app/

About Showrunner

Showrunner is a live streaming auction platform that combines the excitement of traditional auctions with cutting-edge AI technology. The platform features Luna, an advanced AI host that manages auctions 24/7, providing real-time authentication, market analysis, and engaging bidder interactions. Built with Next.js and powered by OpenAI, Showrunner transforms how collectibles, art, and unique items are bought and sold online.

The platform creates an immersive auction experience where AI vision technology authenticates items instantly, intelligent algorithms prevent bid sniping, and natural language processing enables seamless voice bidding. Whether you're a collector looking for rare Pokemon cards, vintage items, or unique collectibles, Showrunner's AI-powered marketplace provides a trusted, engaging, and technologically advanced auction environment.

Key Features

AI Host Luna

  • 24/7 Autonomous Hosting: Luna manages auctions around the clock, providing consistent engagement and professional auction management
  • Real-time Authentication: Advanced AI vision capabilities instantly verify item authenticity and condition
  • Market Intelligence: Provides accurate market value estimates and condition grading based on extensive data analysis
  • Natural Conversation: Responds to bidder questions about items, conditions, and auction details in real-time
  • Voice Integration: Supports voice commands and announcements through ElevenLabs text-to-speech technology

Live Streaming Technology

  • WebRTC Streaming: Real-time video streaming with ultra-low latency for live auction experiences
  • Interactive Chat: Live chat system with AI moderation and real-time bidder communication
  • Viewer Analytics: Track viewer engagement, bid patterns, and auction performance metrics
  • Mobile Optimized: Fully responsive design for seamless mobile auction participation

Advanced Bidding System

  • Voice Bidding: Revolutionary voice-controlled bidding system powered by speech-to-text technology
  • Anti-Snipe Protection: Intelligent algorithms extend auction time when last-second bids are placed
  • Real-time Updates: Instant bid notifications and live price updates across all connected devices
  • Secure Payments: Stripe integration for secure payment processing and fraud protection

AI Vision & Authentication

  • Computer Vision Analysis: Automated condition assessment and authenticity verification
  • Condition Grading: AI-powered condition scoring with detailed analysis reports
  • Image Recognition: Identify items, brands, and authenticity markers automatically
  • Market Comparison: Real-time price comparison with historical sales data

Technology Stack

Frontend

  • Next.js 16 - React framework for production-grade applications
  • TypeScript - Type-safe development with enhanced developer experience
  • Tailwind CSS - Utility-first CSS framework for rapid UI development
  • Framer Motion - Smooth animations and interactive UI components
  • Lucide React - Beautiful, customizable icon library

Backend & AI

  • OpenAI API - GPT-powered conversational AI for Luna's intelligence
  • ElevenLabs - Advanced text-to-speech for voice announcements
  • Supabase - Real-time database with authentication and real-time subscriptions
  • Stripe - Secure payment processing and financial transactions

Real-time Features

  • WebRTC - Live video streaming with minimal latency
  • WebSocket Connections - Real-time bidding and chat functionality
  • Supabase Realtime - Live database updates and synchronization

Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn package manager
  • Supabase account and project
  • OpenAI API key
  • ElevenLabs API key (optional, for voice features)
  • Stripe account for payments (still in development, not implemented just yet)

Installation

  1. Clone the repository

    git clone https://github.com/your-username/showrunner.git
    cd showrunner
  2. Install dependencies

    npm install
  3. Environment Setup Copy ENV_TEMPLATE.txt to .env.local and fill in your API keys:

    cp ENV_TEMPLATE.txt .env.local
  4. Database Setup Run the database setup script:

    chmod +x setup-database.sh
    ./setup-database.sh
  5. Start Development Server

    npm run dev

Visit http://localhost:3000 to see Showrunner in action!

Project Structure

showrunner/
├── app/                    # Next.js 14 app directory
│   ├── api/               # API routes for all backend functionality
│   │   ├── ai-host/       # Luna AI host endpoints
│   │   ├── auction/       # Auction management API
│   │   ├── livestream/    # Live streaming functionality
│   │   ├── payments/      # Stripe payment integration
│   │   └── speech/        # Voice recognition & TTS
│   ├── stream/[id]/       # Dynamic auction stream pages
│   ├── marketplace/       # Browse active auctions
│   └── start-streaming/   # Create new auction streams
├── components/            # Reusable React components
├── hooks/                 # Custom React hooks
├── lib/                   # Core utilities and integrations
│   ├── aiEngine.ts        # Luna AI engine
│   ├── supabase.ts        # Database configuration
│   └── stripe.ts          # Payment processing
└── contexts/              # React context providers

Development Workflow

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

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

Built with ❤️ by the Showrunner team. Transforming auctions through AI innovation.

About

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages