BroCheck — The Open-Source AI Roaster for Playlists, Code & GitHub Profiles

A developer built BroCheck, an open-source Python terminal CLI that uses open-weight AI models such as Llama-3.2, Qwen-2.5 and Mistral to generate comedic roasts of music playlists, source code, GitHub profiles, social bios and chat excuses. The tool parses Spotify, Apple Music, YouTube Music and SoundCloud links, local .txt/.m3u files and public GitHub data without API keys, then applies selectable heat levels and personas including Gordon Ramsay and Tech Bro VC. It was submitted to the Hacktoberfest 2026 DEV Challenge and released under the MIT license.

This is a submission for the Hacktoberfest Weekend Challenge: Build for a Friend https://dev.to/challenges/hacktoberfest-weekend-2026-10-01 What I Built We’ve all got that one friend whose taste and habits desperately need a reality check: - The friend who puts Nickelback , Baby Shark , and Crazy Frog on the same 3 AM roadtrip playlist. - The developer friend who names variables temp var 2 final really final and writes 600-line if/else ladders. - The friend whose GitHub profile has 0 green commit squares this year but their bio screams "10x Senior Full-Stack Architect" . - The friend whose excuses for being 2 hours late to a group hangout defy the laws of physics. To lovingly solve this problem, I built BroCheck — a lightweight, multi-mode terminal CLI powered by Open-Source AI that delivers customized, hilarious roasts on whatever you throw at it. Key Features: - Universal Music Playlist Roaster : Drop any playlist link Spotify, Apple Music, YouTube Music, SoundCloud , local .txt / .m3u files, or raw artist lists. - Code Review Roaster : Analyses any code file .py , .js , .ts , .cpp , etc. for architectural and stylistic sins. - GitHub Profile Roaster : Scrapes public GitHub stats, repos, and bios without requiring API keys, roasting developer habits. - Social Bio & Status Roaster : Dismantles fake-deep gym quotes and corporate LinkedIn buzzwords. - Chat Excuse Roaster : Calls out group chat lies and late arrival excuses. - 3 Heat Levels : Mild playful banter , Spicy sharp satire , and Nuclear pure comedic devastation . - 4 Personas : Best Friend casual slang , Gordon Ramsay "IT'S RAW " , Tech Bro VC negative alpha / zero ROI , and Disappointed Parent "Sharma-ji's son would never" . Demo Here is BroCheck in action across different modes and personas: 1. Roasting a Friend's Roadtrip Playlist Best Friend Persona, Spicy Heat 2. Roasting Spaghetti Code Gordon Ramsay Persona, Nuclear Heat Code The entire codebase is open-source under the MIT license: BroCheck — a lightweight, multi-mode terminal CLI powered by Open-Source AI that delivers customized, hilarious roasts on whatever you throw at it. BroCheck The Open-Source AI Roaster CLI Built for the Hacktoberfest 2026 HF26 DEV Challenge: Build for a Friend BroCheck is a zero-RAM, multi-mode AI roaster CLI that hilariously critiques your friend's music playlists, spaghetti code, barren GitHub profiles, cringey bios, and transparent excuses using Open-Source AI . Features - Universal Music Roaster : Drop any playlist link Spotify, Apple Music, YouTube Music, SoundCloud , upload a .txt / .m3u file, or paste raw song lists. - Code Review Roaster : Point to any .py , .js , .ts , .cpp file for a brutally honest critique of variable names and 6-level nested loops. - GitHub Profile Roaster : Enter any GitHub username to roast empty commit heatmaps, abandoned test repos, and buzzword-packed bios. - Social Bio & Status Roaster : Savage fake-deep gym quotes and LinkedIn buzzwords. - Excuse & Chat Roaster : Roast terrible excuses for being late to group hangs. - Adjustable Heat … Project Structure: How I Built It BroCheck was built using Python and centered around open-source AI: php flowchart TD CLI User Terminal / Interactive Wizard -- Parser{Universal Input Parser} Parser -- |Spotify / Apple / YT Link| LinkExtractor oEmbed & Metadata Scraper Parser -- |.txt / .m3u File| FileHandler Local File Reader Parser -- |GitHub Handle| GHAPI GitHub Public API LinkExtractor & FileHandler & GHAPI -- PromptEngine Prompt & Persona Builder PromptEngine -- OpenEngine Open-Weight AI Engine\nLlama-3.2 / Qwen-2.5 / Mistral OpenEngine -- RichUI Rich Terminal UI & Verdict Card 1. Open-Weight Models : Powered by meta-llama/Llama-3.2-3B-Instruct , Qwen/Qwen2.5-Coder , and mistralai/Mistral-7B . 2. Universal Playlist Scraper : Leverages public oEmbed and metadata endpoints to parse links from Spotify, Apple Music, and YouTube without requiring private API tokens. 3. Public GitHub Fetcher : Retrieves repository names, commit frequencies, and bios directly from GitHub's public API. 4. Rich Terminal Engine : Provides an interactive setup wizard, spinners, result panels, and customizable terminal themes using Python rich . Why Does Open Innovation Matter? This project was developed on a machine with limited RAM 6GB , where running heavy local LLMs would cause system lag and memory thrashing. Open innovation solved this completely: 1. Freedom of Open Weights : We utilize open-weight models Llama-3.2 , Qwen-2.5 , Mistral instead of being locked into closed, proprietary platforms with unpredictable pricing and opaque modifications. 2. 0 MB RAM Footprint : By pairing a lightweight Python client harness with open serverless inference, anyone with budget or low-spec hardware can run and build AI tools with sub-second response times. 3. Friend Data Privacy : Personal group chat texts, private code snippets, and quirky playlist links are not fed into closed commercial model training loops. 4. Uncensored Creative Writing : Closed AI APIs often over-moderate playful humor and satirical character prompts. Open-weight models give developers full control over system instructions, enabling fun personas like Gordon Ramsay screaming at unseasoned code. My Agent Session This project was designed, planned, scaffolded, and tested with DevRelay https://devrelay.com/ and Antigravity. Happy Hacktoberfest 2026 Protect your code, protect your aux cord.