From Commits to Cuisine: HowToCook is a GitHub Repo for Developer Chefs

You’ve mastered version control, but can you control a frying pan? If the idea of following a traditional recipe feels like debugging spaghetti code, you’re not alone. That’s exactly why the GitHub repository HowToCook was created.

What Is HowToCook?

HowToCook is a massive, community-driven cookbook written by programmers, for programmers. Originally created in Simplified Chinese, the project structures recipes with the precision and clarity a developer would expect. No more vague instructions like “add a pinch of salt” or suddenly introducing mystery ingredients halfway through. This is cooking, formalized.

The repo is organized like a well-structured codebase, with directories for dishes, tips (like documentation), and even a starsystem for ranking. It covers everything from kitchen setup and equipment guides to detailed recipes for hundreds of dishes.

Why It’s So Cool

This isn’t just a joke or a meme repo. It’s a seriously practical and cleverly executed project.

• Developer-First Formatting: Recipes are written in Markdown and follow a consistent, logical template. Ingredients are listed upfront, just like declaring variables. Steps are numbered and clear, like well-commented code.
• It’s a Real Cookbook: The scope is impressive. It’s not just “how to boil water.” You’ll find everything from foundational techniques (how to sauté, how to blanch) to specific, complex dishes.
• Open Source to Its Core: With over 92k stars and 10k forks, this is a true community effort. Contributors submit pull requests to fix errors, add new recipes, or improve instructions—just like maintaining any other open-source project.
• Infrastructure Included: The project even has CI/CD set up with GitHub Actions, a Docker container for running a local web server, and a published npm package. They’ve built a full-stack application for cooking.

How to Try It

You don’t need to know Chinese to appreciate the structure, but the primary content is in Chinese. For English speakers, it’s a fascinating look at how to systematize a non-technical process.

1. Browse the Repo: Head over to the HowToCook GitHub repository to explore the codebase-style structure.
2. Run It Locally: For the full experience, you can run the entire cookbook as a local website using Docker:

   docker pull ghcr.io/anduin2017/how-to-cook:latest
   docker run -d -p 5000:80 ghcr.io/anduin2017/how-to-cook:latest
   

   Then visit http://localhost:5000 in your browser.
3. Download the PDF: A pre-built PDF version of the entire cookbook is available for download at cook.aiursoft.cn/document.pdf.

Final Thoughts

HowToCook is the perfect intersection of developer culture and everyday life. It demonstrates how the principles we use in our work—clarity, consistency, collaboration, and version control—can be applied to anything, even the art of cooking. It’s a brilliant, useful, and oddly comforting project. Whether you’re a seasoned chef or someone who can barely operate a toaster, there’s something wonderfully logical about seeing the world through a developer’s eyes.

Follow us for more cool projects @githubprojects