# SOUS AI

- **Event:** [Meta Global AI Developer Hackathon](https://cerebralvalley.ai/e/meta-ai-developer-hackathon)
- **When:** Oct 26, 12:00 PM – Nov 4, 9:00 PM (EST)
- **Where:** Online
- **Team:** [Vince Walsh](https://cerebralvalley.ai/u/vinwalsh)
- **GitHub:** https://github.com/vinwalsh/textsous
- **Demo video:** https://youtu.be/FDqAA_6dRXg
- **Gallery:** https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery
- **Page:** https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/5031

Recipes are written to be read, not cooked from. You scroll past the story, scale amounts in your head, and work out for yourself what to start first.

TextSous Open turns any recipe into a Cook Along, a normalized, and visualized plan for actually cooking it. Give it a recipe link, pasted text, or up to three photos of cookbook pages, and Muse Spark reads it into a structured recipe. Within seconds you see the recipe's facts and allergens and a summary of what you'll do. Then you get a prep list (Mise en Place style) and a schedule with one lane per component of the dish, with a timer on every step and a guided Cook mode. You can adjust it for your table: change the servings, make it dairy-free, gluten-free or vegan, give it a different cuisine, or have it rewritten in SOUS's voice. "Save to TextSous" adds it to your TextSous Cookbook.

It's not just for chefs either - recipe sites can add one script tag to get an "Adjust with SOUS" button. Readers scale or adapt the recipe and the Cook Along opens over the site's own page (so they aren't guided away from the site owner's URL). 

That's not all! When it's time to cook, the Cook Along also runs as a heads-up web app on Meta Ray-Ban Display glasses: the current step, what's next, timers, and each step read aloud as its minute comes. 

You can interact with TextSous via the webpage or by connecting their AI assistant to TextSous over MCP. Try it with Muse! It works great (https://textsous.com/api/mcp)

Everything is open source under MIT: a TypeScript library, a CLI, the web app at https://open.textsous.com, and a documented JSON format with schemas.

What's new: TextSous existed before the hackathon as a private, pre-launch meal-planning app, where SOUS plans your family's week over text. The Cook Along format was designed before the hackathon but is not in production on textsous.com, and the app had an internal, operator-only recipe pipeline. None of that pipeline's code is in this repo. The converter, adjustments, embed, glasses view and handoff in the public repo were written from scratch between Oct 27 and Nov 4. The Cook Along view was built in the TextSous app during the hackathon and ported into the open repo. Inside the private app we also built the Cookbook import and three MCP recipe tools. NEW-WORK.md has the dated log.

## More from Meta Global AI Developer Hackathon

- [Origin](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/5028)
- [Physica](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/5029)
- [straw hats](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/5030)
- [Trackdub](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/5032)
- [JupiterOne](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/5033)
- [Telltale](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/5034)

---

Markdown version of https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/5031. Site index for agents: https://cerebralvalley.ai/llms.txt · full text: https://cerebralvalley.ai/llms-full.txt