# Keel

- **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:** [Shalwin Sanju](https://cerebralvalley.ai/u/shalwin04)
- **GitHub:** https://github.com/shalwin04/keel
- **Demo video:** https://youtu.be/Wv4iYaxgLJQ
- **Gallery:** https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery
- **Page:** https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/3212

Keel is an AI marketing team for Meta ads, built from agents on Meta's own models, with a person approving every decision.

Growing brands sell on Facebook and Instagram, and Meta rewards a steady stream of fresh, well-made ads. Doing that well takes a strategist, a researcher, a designer, a media buyer and an analyst; most teams have one person. And even good ads aren't safe: Meta's Advantage+ creative enhancements can change an ad after it's approved (music, filters, rewritten text, generated backgrounds), and most advertisers never notice.

Autopilot: paste one link and Keel runs the campaign.
1. Read the site: a headless browser reads the brand's site (logo, colours, voice, product catalogue, prices, photos); Muse Wonder turns it into a brand profile, audience and the product to lead with, and why.
2. Research: a Muse Wonder tool-calling agent decides on its own which competitor sites, review pages and Reddit threads to read, and which ads to look at. It returns competitor patterns, what's overused, the open space, and customer personas in customers' exact words.
3. Create: Wonder writes a concept board across proven formats. Muse Image designs each ad whole from its story, with the real product and logo as references and the headline rendered in the image, in styles from studio photo to 3D. Muse Spark acts as retoucher: it checks every word letter by letter and the product against the original, and pre-scores scroll-stop before anything is spent. If text isn't exact, Keel sets the type itself, so a typo never ships. Any design can be refined in plain words; other sizes are re-composed, not cropped.
4. Launch on approval: campaign, ad set and ads created through the Marketing API, paused, with Advantage+ enhancements locked off.
5. Learn: Keel reads results on a schedule; Wonder explains what's winning and proposes moves (pause a loser, raise budget within a cap, a new variant of the winner). Deterministic thresholds decide which moves are allowed; each waits for approval. Lessons go into a brand memory that also learns from the account's past ads.

Watchdog: every ad Keel launches (or any ad in a connected account) is watched. Keel locks the approved enhancement settings, detects drift, renders the variants Meta serves, screens them with Muse Spark Open on Baseten, inspects suspicious ones with Muse Spark against the brand rulebook, and proposes a fix. After approval it relocks the ad through the Marketing API (creatives are immutable, so it clones and swaps) and reads the ad back from Meta to verify. Tested end to end on a live ad account.

Keel Bridge, the web app, holds the review queue, a live agent log, approvals with roles, and a hash-chained audit log of every change.

Everything was built during the hackathon (Oct 27 – Nov 4): TypeScript, LangGraph.js, Hono, Postgres, React.

## More from Meta Global AI Developer Hackathon

- [StillGood](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/3209)
- [Spinach Kitchenless](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/3210)
- [drill](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/3211)
- [Team Ryde Off](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/3213)
- [Rev2Square.com](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/3214)
- [Andrea Pullen](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/3215)

---

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