Kyle and Alex's Personal Recipes. Hosted at https://recipes.kyleking.me

• Search: Full-text search across all recipes
• Related Recipes: Semantic ingredient matching using spaCy NLP for multi-word phrase extraction
• TRMNL E-ink Display: JSON recipe format for TRMNL e-ink devices (800x480 landscape)
  • Change .html to .json in any recipe URL for JSON version
  • See TRMNL Setup Guide for detailed instructions

Required tools:

• mise - Development environment manager
• uv - Python package manager
• System dependencies:
  • macOS: Python development headers (via Xcode Command Line Tools)
  • Linux: python3-dev pkg-config build-essential

1. Clone the repository:

   git clone https://github.com/KyleKing/recipes.git
   cd recipes

2. Install mise:

   # macOS
   brew install mise
   
   # Or follow https://mise.jdx.dev/getting-started.html

3. Install uv:

   # macOS/Linux
   curl -LsSf https://astral.sh/uv/install.sh | sh

4. Install system dependencies (macOS):

   # Xcode Command Line Tools (provides Python headers)
   xcode-select --install

5. Install project dependencies:

   # Install tools via mise (Go, Python, Node packages)
   mise install
   
   # Install Python dependencies and spaCy model
   uv sync
   uv run python -m spacy download en_core_web_sm

6. Build the C++ wrapper for go-spacy:

   # This creates lib/libspacy_wrapper.dylib (macOS) or lib/libspacy_wrapper.so (Linux)
   ./setup-spacy.sh
   
   # Source the generated .env file to set environment variables for local development
   source .env

7. Run tests to verify setup:

   mise run test

8. Build the site:

   mise run build

9. Serve locally:

   mise run serve
   # Visit http://localhost:8000

mise run build      # Build website (format → go run . → minify → pagefind index)
mise run format     # Format code (templ generate → templ fmt → go fmt)
mise run test       # Run tests with coverage
mise run serve      # Serve built site on port 8000

mise run compress <path>   # Compress images
./check_links.py          # Check/fix recipe links, add Wayback archive links

C++ compilation errors:

• Ensure Python development headers are installed (python3-config --includes should work)
• Run ./setup-spacy.sh to rebuild the C++ wrapper
• Check that lib/libspacy_wrapper.dylib (macOS) or lib/libspacy_wrapper.so (Linux) exists

Missing Python dependencies:

• Run uv sync to install Python packages
• Run uv run python -m spacy download en_core_web_sm to install spaCy model

mise tool installation issues:

• Run mise doctor to diagnose issues
• Run mise install to reinstall tools

To display a recipe on your TRMNL e-ink device:

1. Change .html to .json in any recipe URL (e.g., https://recipes.kyleking.me/seafood/shrimp_scampi.json)
2. Create a TRMNL Private Plugin with the Polling strategy
3. Use the JSON URL as the polling URL and format it with Liquid templates