Distribute

A Pi recipe is an ordinary Git-backed package. Its repository remains the source of truth; the open catalog makes compatible recipes discoverable without taking ownership of them.

Publish a portable recipe

Validate the package, publish it to a Git repository, and identify a reproducible release with a commit SHA or a tag protected by an immutable-release policy. The manifest version remains package metadata.

recipes check . --profile publish
recipes publish . --github owner/my-recipe --visibility public

Machine-readable discovery

Agents and other catalogs can consume the stable catalog and its public schema directly. Catalog entries include the unpinned source, verified install ref, license verification status, providers, required and optional capabilities, resource counts, repository, and derived installation command. Volatile popularity and activity data stay in the website API.

https://pi.recipes/catalog.json
https://pi.recipes/catalog.schema.json
https://pi.recipes/llms.txt

Contribute

The tooling, website, and catalog are open source. A public recipe remains independently installable from Git even when it is not listed here.

Run recipes locally or in a compatible host on infrastructure you choose. Introspection maintains Pi Recipes for the Pi community and is the first-party managed cloud for operating and improving recipes, but it is not required to create, distribute, or run one.

https://github.com/introspection-org/pi-recipes
https://github.com/introspection-org/pi-recipes-website
https://github.com/introspection-recipes/pi-recipes-catalog