AI-Powered Haiku Generator

Project overview

A command-line haiku tool combining word transformations, Markov-chain generation, syllable checks and optional audio narration.

A command-line haiku tool combining word transformations, syllable-aware Markov generation and optional narration. The project explores how explicit language rules and bounded generation can produce a reproducible 5–7–5 poem.

Inside this build

• Built synonym, shortest-synonym, antonym and batch-permutation modes with punctuation and capitalisation handling.
• Implemented syllable-aware Markov generation with bounded retries and fallbacks for the 5–7–5 structure.
• Added optional WAV narration assembled from word-level audio clips.
• Separated tokenised lines, keyword indexing, syllable counting, thesaurus lookup, haiku generation and file handling into six abstractions.
• Validated command-line input and file availability, and added 16 tests with 54% coverage.
• Recorded a deterministic 5–7–5 example from a 12-line corpus; this demonstrates the generation path rather than general poetic quality.

Source code & links