GutenKu

Haiku poetry crafted from classic literature

gutenku.xyz

🌸 · 🌸 · 🌸

Daily Haiku Card

"This haiku captures the sudden collapse of certainty. The opening line, "My mind was made up," suggests confidence, decision, and finality. But the next line, "and now falling to pieces," overturns that firmness, showing a mind breaking apart under pressure, doubt, or emotional strain. The final phrase, "at no great distance," adds a haunting sense of closeness: the breakdown is not far away in time or space, but immediate and near. Together, the lines create a powerful contrast between resolve and disintegration, suggesting that even the strongest decisions can quickly unravel." — BotenKu 📅 Jul 19, 2026

🌸 · 🌸 · 🌸

About

GutenKu transforms classic literature from Project Gutenberg into haiku poetry using NLP, Markov Chain algorithms, and OpenAI for selection and narrative generation.

Features

• AI-Powered Selection — OpenAI refines haiku choices and generates poetic narratives
• Self-Learning — Neural network discovers quality patterns by observing which haiku survive evolution
• Daily Puzzle Game — Guess the source book from haiku clues
• Shareable Cards — Generate beautiful image cards for social media
• Sentiment Analysis — Score and filter haikus by emotional tone

How It Works

1. Scrape — Collect texts from a curated whitelist of eBooks on Project Gutenberg
2. Process — Apply Markov Chain to sequence sentences with highest transition probabilities
3. Structure — Enforce traditional 5-7-5 syllable structure via NLP
4. Evolve — Genetic algorithm optimizes haiku through natural selection; a neural network learns which patterns survive
5. Select — Choose candidates and generate narratives with OpenAI
6. Render — Create shareable image cards

Quick Start

git clone https://github.com/heristop/gutenku.git
cd gutenku
make install
make build
make dev

Run make help for all available commands.

Tech Stack

Package	Technologies
Server	TypeScript, GraphQL, Apollo Server, MongoDB, OpenAI
Front	TypeScript, Vue 3, Pinia, URQL, Cypress

Acknowledgments

Thanks to the creators and maintainers of Project Gutenberg for providing the texts.

License

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

🌸 · 🌸 · 🌸

© 2023-2026 heristop / @gutenku.poem