waifetch

A fun CLI that displays random anime girls holding programming books in your terminal

---

Features

• Dynamic terminal display with images rendered directly in your terminal
• Smart sizing that automatically adapts to your terminal dimensions
• Language-specific fetching with support for all major programming languages
• High-quality rendering using chafa with 256 colors and ordered dithering

Installation

Required Dependencies

For image rendering, install chafa:

Important

chafa is required for displaying images in the terminal. The CLI will not work without it.

# Ubuntu/Debian
sudo apt install chafa

# macOS
brew install chafa

# Arch Linux
sudo pacman -S chafa

# Fedora/RHEL
sudo dnf install chafa

# Nix
nix-env -iA nixpkgs.chafa

Via go install

go install github.com/ashish0kumar/waifetch@latest

Build from Source

git clone https://github.com/ashish0kumar/waifetch.git
cd waifetch/
go build
sudo mv waifetch /usr/local/bin/
waifetch --help

Usage

# Random image from any language
waifetch

# List all available languages
waifetch --list

# Specific languages
waifetch --lang Go
waifetch --lang "C++"
waifetch -l Rust

# Get help
waifetch --help

Configuration

GitHub API Rate Limits

For higher rate limits, set up a GitHub Personal Access Token:

1. Go to GitHub Settings → Developer settings → Personal access tokens
2. Click "Generate new token (classic)"
3. Give it a name like "waifetch-cli"
4. No scopes needed for public repositories
5. Copy the token and set it as an environment variable:

export GITHUB_TOKEN="your_token_here"
waifetch

Rate Limits

Authentication Method	Rate Limit
Unauthenticated	60 requests/hour
Personal Access Token	5,000 requests/hour

Contributing

Contributions are always welcome! Please feel free to open an issue or submit a pull request.

Dependencies

• chafa - High-quality terminal image rendering
• Cobra - CLI framework and command structure
• golang.org/x/term - Terminal size detection

Data Source

Images are fetched from the excellent Anime-Girls-Holding-Programming-Books repository by cat-milk, which contains hundreds of high-quality images of anime girls featuring various programming books.

Acknowledgments

• Thanks to cat-milk for the amazing Anime-Girls-Holding-Programming-Books repository
• Built with love for the intersection of anime culture and programming

© 2025-present Ashish Kumar