Programmer's guide about how to cook at home.
101.1k
Stars
11k
Forks
461
Open issues
100+
Contributors
AI Analysis
HowToCook is a community-driven, open-source cookbook written in a structured, specification-like format aimed at programmers who find traditional recipe writing imprecise and inconsistent. It covers a large range of Chinese home-cooking recipes — vegetable dishes, meat dishes, soups, staples, and kitchen tips — with a focus on clarity and reproducibility. It is best suited for Chinese-speaking developers looking for clearly formatted cooking guidance; it is not a general-purpose Western reci...
Inferred from signals mentioned in the README (tests, CI, type safety) — not a review of the actual code.
AI's overall editorial judgment — not an average of the bars above, can weigh other factors too.
Chinese cooking guide built for programmers, with 100k+ stars and structured recipes
HowToCook is a community-driven Chinese-language cookbook repository that presents home cooking recipes in a structured, unambiguous format designed to appeal to programmers who find typical recipe writing too informal and inconsistent. It targets Chinese-speaking developers who want to cook at home but find mainstream recipe sources frustratingly imprecise. With over 100k GitHub stars, a Docker-deployable web viewer, and hundreds of contributors, it occupies a unique intersection of developer culture and everyday practical utility.
Created in February 2020 during COVID-19 lockdowns, it emerged when many programmers in China were suddenly homebound and cooking for themselves. It grew virally within the Chinese developer community.
The initial viral spike was driven by COVID-19 lockdowns in early 2020, which created a sudden and relatable need among Chinese programmers stuck at home. The framing — treating recipes like formal specifications — resonated strongly in developer communities and spread rapidly via social media and tech forums. Community contributions sustained growth over six years, and 248 stars in the last 7 days indicate continued organic discovery.
Docker Hub pull count is displayed as a badge, suggesting measurable deployment usage. The hosted website (howtocook.aiursoft.com) is live and monitored via a website badge. Real-world adoption among Chinese-speaking home cooks and programmers is strongly implied by 100k+ stars and 11k+ forks, though precise usage metrics beyond these signals are not documented in the README.
Appears to be primarily a Markdown document repository with categorized directories for different recipe types. Likely uses a static site generator or custom web viewer served via Docker. The Docker image (aiursoft/howtocookviewer) suggests a separate frontend application that indexes and renders the Markdown files. Authentication is present in the web viewer (default admin credentials), suggesting a more capable deployment than a simple static site.
Not documented in README. As a content repository rather than a software project, traditional test coverage is not applicable. Contribution quality is likely managed through pull request review against a template.
Last push was June 16, 2026 — four days before the current date — indicating active maintenance. The project has been continuously maintained for over six years since February 2020. Contributor count badge and a man-hours tracker suggest ongoing community engagement. The project appears healthy and not at risk of abandonment.
ADOPT IF: you are a Chinese-speaking programmer or technically-minded home cook who values precise, unambiguous recipe instructions and wants a self-hostable, ad-free cooking reference. AVOID IF: you need English-language recipes, advanced culinary techniques beyond home cooking, or prefer video-based instruction — this project does not serve those needs. MONITOR IF: you are interested in community-maintained knowledge repositories as a model, or if you want to contribute recipes — the project remains actively accepting contributions.
Independent dimensions
Mainstream potential
3/10
Technical importance
2/10
Adoption evidence
6/10
- The project is entirely in Chinese, permanently limiting its audience to Chinese-speaking users and making international adoption essentially impossible without a translation effort.
- Content quality consistency depends on community pull request review; recipe accuracy is not formally verified, and errors may persist until noticed by contributors.
- The Docker-based web viewer introduces a dependency on a separately maintained application (aiursoft/howtocookviewer) whose maintenance cadence and security posture are not documented in this README.
- As a content repository rather than a software tool, it has limited defensibility against content being copied or forked into competing platforms without attribution, given the Unlicense license.
- Growth may plateau as the most common Chinese home-cooking recipes become well-covered, reducing the motivation for new contributions over time.
Likely to remain a stable, well-maintained reference for Chinese-speaking programmers indefinitely, growing slowly through community contributions. Mainstream expansion beyond its current audience appears unlikely without active internationalization efforts.
Newsletter
Get analyses like this every Monday
Free weekly digest of the most interesting open-source discoveries.
Languages
No language breakdown available.
Information
- Website
- https://howtocook.aiursoft.com
- License
- Unlicense
- Last updated
- 1w ago
- Created
- 77mo ago
- Analyzed with
- anthropic/claude-sonnet-4-6
Stars over time
Contributors over time
Top 100 contributors only — repos with more will plateau at 100.
Open issues
Open pull requests
Top contributors
Recent releases
Similar repos
TandoorRecipes/recipes
Tandoor Recipes is a self-hosted recipe management application that helps users...
| Repository | Stars | Week Δ | Language | Score | Updated |
|---|---|---|---|---|---|
|
Anduin2017/HowToCook
this
|
101.1k | +112 | — | 7/10 | 1w ago |
 YunYouJun/cook
|
6.4k | — | TypeScript | 7/10 | 3mo ago |
 Byron4j/CookBook
|
1k | — | Java | 7/10 | 2mo ago |
|
TandoorRecipes/recipes
|
8.4k | — | HTML | 8/10 | 6d ago |
 cooklang/cookcli
|
1.3k | — | Rust | 7/10 | 1w ago |
 hendricius/the-bread-code
|
4.1k | — | Shell | 6/10 | 6mo ago |
A TypeScript-based project with 6.4k stars that appears to be a more technical cooking app, likely with interactive features. HowToCook is simpler in tooling but far more adopted and content-rich.
Mainstream Chinese recipe platforms prioritize visual media and social features. HowToCook differentiates by offering precise, programmer-friendly text-based instructions without ads or algorithmic noise.
Despite sharing the 'cookbook' term, this is entirely different — it covers LLM usage patterns for AI developers. No meaningful overlap with HowToCook's domain.
Similarly unrelated despite the name — focused on Claude API usage examples. Included in similar repos list likely due to keyword matching, not actual category overlap.
HowToCook's key advantage over static recipe books is community editability, version control, and the ability to self-host or deploy locally via Docker.
