Rye logoRyelanguage

Cookbook

Overview

Contrib packages

Contrib packages are bindings for third-party and less-official technologies that live in the contrib/ folder of the Rye repository. They are opt-in: each one is compiled into Rye only when the matching build tag is given.

To use a contrib package you must build Rye with two tags: the general b_contrib tag, and the tag for the specific package. For example:

go build -tags "b_contrib,b_maxmind"

The recipes here cover the following packages:

  • MaxMind GeoLite — IP geolocation (country and ASN lookups)
  • Bleve — full-text search and indexing
  • AWS — Amazon S3 and SES
  • Postmark — transactional email
  • Surf — browser automation and web scraping
  • MPV — audio and video playback
  • Ollama — local language models and embeddings

MaxMind GeoLite

IP geolocation with MaxMind GeoLite2 country and ASN databases.

Bleve

Full-text search and indexing with Bleve.

AWS

Amazon S3 and SES through the AWS SDK.

Postmark

Sending transactional email with Postmark.

MPV

Play audio and video with the MPV media player.

Ollama

Local language models and embeddings with Ollama.