julianpoy/RecipeSage

What is it?

Key features

• 01Imports recipes from URLs, images, PDFs, text, and many recipe apps
• 02Drag-and-drop meal planning that can be printed and shared
• 03Shopping lists that auto-categorize items and combine similar ingredients
• 04Offline search with sync across devices
• 05Recipe scaling and metric/imperial unit conversion
• 06Per-serving nutrition tracking

Use cases

• Keeping a shared family recipe collection accessible from any device
• Planning weekly meals and generating a combined shopping list
• Migrating recipes from another recipe manager into one place
• Self-hosting a private recipe and meal planning service

Quick start

1. 1

   Enable corepack so the pinned pnpm version is used

   corepack enable
2. 2

   Install dependencies at the repo root

   pnpm install
3. 3

   Start the Docker containers

   docker compose up -d
4. 4

   Run database migrations, then open localhost on port 80

   docker compose exec backend pnpm exec prisma migrate dev

Things to know

• !Commercial use requires a separately negotiated paid license; non-commercial use is under AGPL-3.0.
• !Some features, such as AI assistant and other dependent functionality, need a real API key configured in .env.
• !The self-hosting setup described here is oriented toward development rather than easy deployment.

In collections

Topics

FAQ

What is RecipeSage?

A collaborative recipe keeper, meal planner, and shopping list organizer, delivered as a PWA that works offline and syncs across devices. RecipeSage is a web app for storing, searching, and sharing recipes. It can import recipes from URLs, images, PDFs, and plain text, and it supports a range of recipe manager and notes app export formats. Recipes stay searchable offline and sync across devices.

Is RecipeSage free to use? What license does it have?

RecipeSage has no declared license. Its code is public, but without a license you have no explicit permission to reuse it; ask the author before relying on it.

Is RecipeSage still maintained?

Actively maintained. The last commit to RecipeSage was on Nov 4, 2026.

What can I use RecipeSage for?

Keeping a shared family recipe collection accessible from any device Planning weekly meals and generating a combined shopping list Migrating recipes from another recipe manager into one place Self-hosting a private recipe and meal planning service

How do I install RecipeSage?

Enable corepack so the pinned pnpm version is used: corepack enable Install dependencies at the repo root: pnpm install Start the Docker containers: docker compose up -d Run database migrations, then open localhost on port 80: docker compose exec backend pnpm exec prisma migrate dev

Where can I get RecipeSage?

The source code and installation instructions are on GitHub: https://github.com/julianpoy/RecipeSage