Uncluttered

Cooking, clarified.

AI-powered recipe extraction for the terminal. Type a search query, get clean ingredients and steps. No ads, no life stories, no scrolling.

Install

pip install uncluttered

By default, only the Gemini provider is included. To use other LLM providers:

pip install "uncluttered[openai]"      # For OpenAI
pip install "uncluttered[anthropic]"   # For Anthropic Claude
pip install "uncluttered[ollama]"      # For Ollama (local)
pip install "uncluttered[all]"         # All providers

Or install from source:

git clone https://github.com/brendaninnis/uncluttered-cli.git
cd uncluttered-cli
pip install -e .

Setup

You'll need API keys for a search provider and an LLM provider:

1. LLM (AI extraction) — choose one:
   • Gemini (default): https://aistudio.google.com/apikey
   • OpenAI: https://platform.openai.com/api-keys
   • Anthropic: https://console.anthropic.com/settings/keys
   • Ollama: https://ollama.com (runs locally, no API key needed)
2. Tavily (recipe search): https://tavily.com (free tier available)

Create a .env file in your working directory:

cp .env.example .env

Then use a text editor to update the file with your keys:

# Choose your LLM provider (default: gemini)
LLM_PROVIDER=gemini

# Only the key for your chosen provider is required:
GEMINI_API_KEY=your-gemini-key
# OPENAI_API_KEY=your-openai-key
# ANTHROPIC_API_KEY=your-anthropic-key

# For Ollama: no API key needed, just set LLM_PROVIDER=ollama and LLM_MODEL
# LLM_MODEL=llama3.1

TAVILY_API_KEY=your-tavily-key

Usage

Search for recipes

uncluttered search "chocolate chip cookies"

This searches for recipes, extracts them using AI, saves them locally, and displays the top results ranked by trust score.

Options:

• --fetch N / -f N: Number of recipes to fetch (default: 5)
• --display N / -d N: Number of results to display (default: 3)

View a saved recipe

uncluttered show classic-chocolate-chip-cookies

List saved recipes

uncluttered list "chocolate chip cookies"

Delete recipes

# Delete a single recipe by slug
uncluttered delete classic-chocolate-chip-cookies

# Delete all recipes for a search term
uncluttered delete --search-term "chocolate chip cookies"

# Delete all saved recipes
uncluttered delete --all

Trust Scores

Each recipe gets an AI-assessed trust score (0-100) reflecting how reliably it would produce a good result. The LLM evaluates recipes holistically, considering measurement precision, instruction completeness, source credibility, and whether the techniques make culinary sense.

• 85-100: Exceptional — precise, well-tested, confidently recommended
• 65-84: Solid — clear and complete with minor gaps
• 45-64: Adequate — functional but vague in places
• Below 45: Unreliable — significant gaps or questionable techniques

Recipes are sorted by trust score, so the best ones appear first.

Data Storage

Recipes are saved locally in ~/.local/share/uncluttered/uncluttered.db (SQLite).

License

MIT