A Debian package providing 5,698 Swahili proverbs in a fortune-like command-line tool.
# fortune-swahili
5,698 Swahili proverbs in a cross-platform command-line tool.
Runs on **Linux**, **macOS**, and **Windows**.
## Quick Install
### pip — any platform (Linux, macOS, Windows)
```bash
pip install fortune-swahili
```
### apt — Debian / Ubuntu / Linux Mint
```bash
# Add GPG signing key
curl -fsSL
giftcharles.github.io | \
gpg --dearmor | \
sudo tee /etc/apt/trusted.gpg.d/fortune-swahili.gpg > /dev/null
# Add repository
echo "deb [signed-by=/etc/apt/trusted.gpg.d/fortune-swahili.gpg]
giftcharles.github.io stable main" | \
sudo tee /etc/apt/sources.list.d/fortune-swahili.list
# Update and install
sudo apt update
sudo apt install fortune-swahili
```
See INSTALL.md for macOS, Windows, Fedora/Arch, and other options.
## Usage
```bash
fortune-swahili # one random proverb
fortune-swahili --count 3 # three proverbs
fortune-swahili --censor-nsfw # filter adult content
fortune-swahili -h # full help
```
## Features
- 🌍 **5,698 Swahili proverbs** from 59 categories
- 🖥️ **Cross-platform** — pip install works on Linux, macOS, Windows
- 🔐 **GPG-signed apt repository** for Debian/Ubuntu users
## Data Source
Proverbs scraped from Swahili Proverbs Database maintained by the University of Illinois.
## Categories
Includes proverbs about: Abuse, Alertness, Ambition, Anger, Appearance, Association, Borrowing, Compatibility, Consequences, Constancy, Consultation, Contentment, Cooperation, Cunning, Death, Decision, Drinking, and many more...
## Repository Details
- **URL**:
giftcharles.github.io
- **GPG Key ID**: 6C365AAADEC5D261
- **Fingerprint**: A8CE 059B 44D0 BAEF BB63 072A 6C36 5AAA DEC5 D261
- **Package**: fortune-swahili_0.1_all.deb (364KB)
## Verification
Verify the repository signature:
```bash
curl -s
giftcharles.github.io | gpg --verify
```
## Documentation
- INSTALL.md - Detailed in …