feat: initial release of bard v1.0.0

This commit is contained in:
2026-10-03 05:54:36 +03:00
commit aa065c7aae
14 changed files with 609 additions and 0 deletions
+44
View File
@@ -0,0 +1,44 @@
# Bard
Wikidata & Wikisource Powered Curated Random Poetry Discovery & Archival Engine.
Author: **Dr. Simon Vance (Simon the Coder)** (`simonthecoder`)
---
## Features
- **Taste Configuration:** Configure language / nationality (English, Turkish, Persian, French, German, etc.), historical era/century, and minimum popularity score (1 to 5).
- **Random Poem Discovery:** Displays random world masterworks and archival verses matching your preference.
- **Offline Library & Auto-Save:** When `--save on` is configured, every poem read is archived into local SQLite storage for offline reading.
- **Pre-Seeded Masterworks:** 100% functional offline from the first second.
---
## Usage
```bash
# Read a random poem matching current configuration
bard
# Read a random Turkish poem from the 13th century
bard --lang turkish --era 13th
# Configure preferences interactively
bard config --interactive
# Toggle auto-saving on/off
bard config --save on
# Browse your saved offline library
bard library
# Read a specific saved poem from library
bard library 1
```
---
## License
MIT License.