Transform Songs into Amazing Parodies

AI-powered parody generator with perfect syllable matching, rhyming schemes, semantic coherence, and artistic style that amazes

yankovinator
$ swift run yankovinator lyrics.txt
Generating parody with
✨ Perfect syllable matching
🎵 Rhyming scheme: ABAB
🎨 Semantic coherence & theme
✨ Artistic style that amazes

Powerful Features

Word-by-Word Syllable Matching

Each word is substituted with the exact same number of syllables, maintaining perfect rhythm and flow.

Automatic Rhyme Detection

Detects and enforces rhyming schemes (ABAB, AABB, AAAA) automatically from original lyrics.

Semantic Coherence

Generates cogent, meaningful lyrics with semantic coherence across lines, building narrative flow and advancing themes naturally.

Aa

Capitalization & Punctuation Matching

Automatically matches the exact capitalization and punctuation style of the original song, preserving every comma, apostrophe, and capital letter.

Keyword Generation

Generate theme keywords from subjects using Ollama LLM for custom parody themes.

NaturalLanguage Framework

Uses Apple's NaturalLanguage for accurate syllable counting and linguistic analysis.

Ollama Integration

Powered by local LLM (llama3.2:3b) for privacy-focused, high-quality text generation.

See It In Action

Original Lyrics

Generated Parody

Click "Generate Parody" to see the magic!

Documentation

Technical Paper

Comprehensive technical documentation covering architecture, algorithms, API reference, and implementation details.

Download PDF

Presentation

Slide deck presentation covering overview, features, usage examples, and technical highlights of Yankovinator.

Download PDF

Reference Manual

Comprehensive API reference documentation with function signatures, parameters, return types, usage examples, and best practices.

Download PDF

Quick Start

1

Add the Homebrew Tap

brew tap shyamalschandra/yankovinator
2

Install Yankovinator

brew install yankovinator
3

Install Ollama

Download and install Ollama from ollama.ai/download

Or install via Homebrew (recommended for macOS):

brew install --cask ollama-app

Or install CLI version: brew install ollama

4

Start Ollama

If using GUI app: Launch Ollama from Applications (runs automatically). If using CLI:

ollama serve
5

Download llama3.2:3b Model

In Ollama GUI: Search for "llama3.2:3b" and click Download. Or via CLI:

ollama pull llama3.2:3b
6

Generate Your First Parody

yankovinator lyrics.txt --keywords themes.txt
1

Clone the Repository

git clone https://github.com/shyamalschandra/Yankovinator.git
2

Build the Project

cd yankovinator && swift build
3

Install Ollama

Download and install Ollama from ollama.ai/download

Or install via Homebrew (recommended for macOS):

brew install --cask ollama-app

Or install CLI version: brew install ollama

4

Start Ollama

If using GUI app: Launch Ollama from Applications (runs automatically). If using CLI:

ollama serve
5

Download llama3.2:3b Model

In Ollama GUI: Search for "llama3.2:3b" and click Download. Or via CLI:

ollama pull llama3.2:3b
6

Generate Your First Parody

swift run yankovinator lyrics.txt --keywords themes.txt