Repolode
Submit
Anduin2017

Anduin2017/HowToCook

A programmer-oriented collection of home cooking recipes written as clear, structured steps, with a web viewer and Docker deployment.

View on GitHubWebsite
Stars
103,648
Forks
11,200
Open issues
470
Last commit
12 days ago

What is it?

HowToCook is a community-maintained collection of home recipes written for people who prefer precise, structured instructions over the loosely written steps common in online recipes. Each dish is a Markdown file that lists ingredients and procedures in a consistent format, covering vegetable dishes, meat, seafood, breakfast, staples, soups, drinks, condiments and desserts.

Beyond individual dishes, the repository includes tip guides on kitchen setup, dishwashing, cooking techniques such as blanching, stir-frying, steaming and knife work, and advanced topics like sugar color and oil temperature judgment. Contributors are invited to submit pull requests using a provided recipe template.

A web viewer is available online, and a Docker image can run the recipe site locally. The project has also spawned derivative tools, including MCP servers that let AI assistants suggest meals and apps that generate shopping lists.

Key features

  • 01Recipes follow a consistent Markdown template with ingredients and steps laid out clearly.
  • 02Covers dishes across vegetables, meat, seafood, breakfast, staples, soups, drinks and desserts.
  • 03Includes technique guides for knife work, blanching, stir-frying, steaming and more.
  • 04Provides a web viewer and a Docker image for running the recipe site locally.
  • 05Open to community contributions via pull requests.

Use cases

  • Looking up a step-by-step recipe for a common home dish.
  • Learning basic cooking techniques as a beginner.
  • Building a recipe app or AI meal assistant on top of structured dish data.
  • Hosting a private recipe site on a home server with Docker.

Quick start

  1. 1

    Install Docker, then pull the viewer image

    docker pull aiursoft/howtocookviewer
  2. 2

    Run the recipe web service on port 5000

    docker run -d -p 5000:5000 aiursoft/howtocookviewer
  3. 3

    Or browse the recipes online at the official website without installing anything

Things to know

  • Local deployment requires Docker.

In collections

Static site generators & documentation tools

Topics

#cooking#recipes#home-cooking#chinese-food#markdown#cookbook#chinese#dishes

FAQ

What is HowToCook?
A programmer-oriented collection of home cooking recipes written as clear, structured steps, with a web viewer and Docker deployment. HowToCook is a community-maintained collection of home recipes written for people who prefer precise, structured instructions over the loosely written steps common in online recipes. Each dish is a Markdown file that lists ingredients and procedures in a consistent format, covering vegetable dishes, meat, seafood, breakfast, staples, soups, drinks, condiments and desserts.
Is HowToCook free to use? What license does it have?
HowToCook is open source under the Unlicense license. Check the license terms before using it in commercial products.
Is HowToCook still maintained?
Actively maintained. The last commit to HowToCook was on Oct 26, 2026.
What can I use HowToCook for?
Looking up a step-by-step recipe for a common home dish. Learning basic cooking techniques as a beginner. Building a recipe app or AI meal assistant on top of structured dish data. Hosting a private recipe site on a home server with Docker.
How do I install HowToCook?
Install Docker, then pull the viewer image: docker pull aiursoft/howtocookviewer Run the recipe web service on port 5000: docker run -d -p 5000:5000 aiursoft/howtocookviewer Or browse the recipes online at the official website without installing anything
Where can I get HowToCook?
The source code and installation instructions are on GitHub: https://github.com/Anduin2017/HowToCook

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects