Skip to content

heristop/gutenku

Repository files navigation

GutenKu

GutenMage illustration

Haiku poetry crafted from classic literature

Server Front License

gutenku.xyz

🌸 · 🌸 · 🌸

Daily Haiku Card

Daily Haiku Card

"This haiku captures the tense atmosphere of conflict through sharp, questioning language. The phrase "where the fighting is" suggests a search for the battlefield or the center of danger, while "who demanded the watchword" hints at authority, secrecy, and discipline. The final line, "in a warlike tone," intensifies the mood, showing aggression and urgency. As a whole, the poem evokes the sound and pressure of war, where even speech carries force and suspicion."

BotenKu 📅 Jul 25, 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

About

Where classic literature meets AI poetry. Generate unique haiku from Project Gutenberg's free eBooks using NLP, Markov chains, Genetic Algorithm, Neural Networks, and OpenAI to craft evocative lines and insightful literary snapshots 🌸 · 🌸 · 🌸

Topics

Resources

Security policy

Stars

Watchers

Forks

Used by

Contributors

Languages