Skip to content

tcsenpai/keyfleur

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌸 Keyfleur

Keyfleur is a poetic API key generator — blending structure and beauty into every token.
Whether you want a delicate haiku, a steampunk sigil, or a mythic mantra,
Keyfleur creates keys that are elegant, readable, and never boring.


🔧 Installation

pip install .

🚀 CLI Usage

keyfleur --theme=forest --mode=haiku --count=3

Options

Option Description
--theme The semantic dictionary to draw words from.
(haiku, forest, mythic, sunny, etc.)
--mode The structural format of the key.
(haiku, sigil, quartz, mantra, etc.)
--count Number of keys to generate. Default is 1.

✨ Modes

Mode Description
haiku A 5-7-5 syllable poetic identifier.
lace Symmetric structure with mirrored syllables.
mirrora Reversed syllable pairs (e.g., im-mi).
rune A haiku fused with a time-based symbolic rune.
sonnet Two-part name with soft romantic cadence.
sigil Word-number-word combo, evocative of arcane codes.
seed Short base+hex identifier, suitable for seed values.
mantra Repetitive and affirming (e.g., Glow-Glow-Sky).
quartz Crystal-inspired symmetrical compound (e.g., Opal22.22lApO).

🌿 Themes

Themes determine the pool of vocabulary used:

  • haiku – melodic invented roots
  • nocturnal – night, shadow, echo
  • sunny – light, warmth, radiance
  • floreal – flowers, petals, blooming
  • forest – leaves, moss, trees
  • desert – dust, sand, mirage
  • celestial – stars, moons, galaxies
  • crystalline – gems, quartz, clarity
  • oceanic – tides, coral, depths
  • mythic – runes, phoenixes, arcane
  • library – ink, scrolls, tomes
  • decay – rust, ash, erosion
  • steampunk – cogs, brass, valves

🧪 Example

keyfleur --theme=celestial --mode=haiku

Might output:

Nova-DriftingOrbit-Moonlight

🧠 Use cases

  • Generate poetic API keys or user-facing identifiers
  • Use in games, lore systems, or design prototypes
  • Inject elegance into otherwise boring IDs

Made without a goal

Releases

No releases published

Packages

No packages published

Languages