Skip to content

Starz099/whiff.gg

Repository files navigation

WHIFF.GG

A platform that roasts Valorant players based on their stats.

About

WHIFF.GG fetches Valorant player statistics from tracker.gg and generates AI-powered roasts based on performance. Built with Next.js, combining web scraping and AI generation with a Valorant-themed UI.

Features

  • Player stats scraping from Valorant tracker using Puppeteer
  • AI-powered roast generation via GitHub Models API (GPT-4o-mini)
  • Player validation for public accounts
  • Comprehensive stats display (rank, K/D, win rate, etc.)
  • Headless browser automation

How It Works

  1. User enters Valorant player ID (e.g., Player#TAG)
  2. App validates player existence and public profile status
  3. Scrapes detailed statistics from tracker.gg
  4. Sends stats to GitHub Models API for roast generation
  5. Displays roast and stats in Valorant-themed interface

Tech Stack

  • Frontend: Next.js 16, React, TailwindCSS, shadcn/ui
  • Scraping: Puppeteer with Stealth Plugin
  • AI: GitHub Models API (GPT-4o-mini)

Important Limitations

This project only works in local development environments.

Valorant tracker.gg actively blocks requests from cloud/production environments like vercel.

Getting Started

Prerequisites

  • Node.js 18+
  • GitHub Personal Access Token with access to GitHub Models

Installation

  1. Clone the repository:
git clone https://github.com/Starz099/whiff.gg.git
cd whiff.gg
  1. Install dependencies:
npm install
  1. Create a .env file in the root directory:
GITHUB_AI_TOKEN=your_github_token_here
  1. Run the development server:
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev
  1. Open http://localhost:3000 with your browser.

Environment Variables

  • GITHUB_AI_TOKEN: GitHub Personal Access Token with access to GitHub Models API

API Endpoints

  • POST /api/roast: Validates player, fetches stats, and generates roast
    • Body: { userId: "PlayerName#TAG" }
    • Returns: { message: string, stats: object }

Contributing

Contributions are welcome. Open an issue or submit a pull request for improvements or bug fixes.

License

This project is for educational purposes. Please respect tracker.gg's terms of service.

About

A fun web app where users enter their Valorant ID, get their stats scraped from Valorant Tracker, and receive an AI-generated roast based on their performance.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors