> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maximem.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cookbook

> Complete, opinionated reference agents you can clone, modify, and ship. Each recipe shows one production-shape pattern end-to-end.

The Cookbook is Synap's **examples manual**. Each recipe is one complete agent: what it does, when to use it, the stack it runs on, and the code to build it. Most live in our playground; the rest are in active development and ship as the recipe drops.

<Note>
  **Try before you build.** Every recipe has a [Playground](https://synap.maximem.ai/playground) companion you can poke at without writing a line of code. Bring API keys to the playground if you want to fork and run.
</Note>

## How to read a recipe

Every page follows the same skeleton, in this order:

1. **What you'll build**: outcome bullets, est. build time
2. **When to use this recipe**: concrete signals so you can tell if it fits your problem
3. **Architecture at a glance**: one diagram, no jargon
4. **Stack**: language, framework, plugins, channel
5. **Build it**: step-by-step with Python and TypeScript side-by-side in code tabs
6. **Run & verify**: start it locally, see memory persistence working
7. **Customize / extend**: links to swap channels, add plugins, change scoping
8. **Troubleshooting**: recipe-specific gotchas
9. **Related**: framework integrations, plugins, and concepts referenced

All code samples follow Synap's [SDK-only guidance](/sdk/initialization): no raw REST, no curl, just the SDK you've already installed.

## Status legend

<CardGroup cols={2}>
  <Card title="Live in Playground" icon="circle-play">
    Reference implementation runs on [synap.maximem.ai/playground](https://synap.maximem.ai/playground). Recipe code matches.
  </Card>

  <Card title="In Development" icon="hammer">
    Recipe is written and runnable. Playground demo is being built. Check back soon.
  </Card>
</CardGroup>

## Consumer Agents

User-facing assistants for end-user products. Memory is keyed per consumer; one customer\_id covers the whole product.

<CardGroup cols={2}>
  <Card title="Uber: Customer Support" icon="car" href="/cookbook/consumer-uber">
    Live in Playground · Rider-aware support agent with refunds, lost-item reports, and human handoff.
  </Card>

  <Card title="Amazon: Shopping Assistant" icon="bag-shopping" href="/cookbook/consumer-amazon">
    Live in Playground · Catalog-grounded shopping concierge with order history and preference recall.
  </Card>
</CardGroup>

## Support Agents

Internal-or-external support workflows with escalation, ticketing, and cross-tier handoff.

<CardGroup cols={2}>
  <Card title="Tier-1 → Tier-2 Escalation Cluster" icon="layer-group" href="/cookbook/support-tier-escalation">
    In Development · Multi-agent cluster: T1 triage agent hands off to T2 specialist with shared memory.
  </Card>
</CardGroup>

## WhatsApp Agents

Inbound + outbound WhatsApp Business API agents. Memory survives across sessions and human handoffs.

<CardGroup cols={2}>
  <Card title="Single-WABA Inbound + Human Handoff" icon="comments" href="/cookbook/whatsapp-single-handoff">
    In Development · One WABA number, AI takes inbound, drops to human agent on signal, picks back up cleanly.
  </Card>

  <Card title="Single-WABA Inbound + Outbound Campaign" icon="paper-plane" href="/cookbook/whatsapp-single-campaign">
    In Development · One WABA number running scheduled outbound campaigns alongside inbound support.
  </Card>

  <Card title="Multi-WABA Same-Business Shared Memory" icon="share-nodes" href="/cookbook/whatsapp-multi-waba-shared">
    In Development · Multiple WABA numbers under one business, one shared customer memory pool.
  </Card>
</CardGroup>

## Voice Agents

Real-time voice agents with memory injection inside voice latency budgets.

<CardGroup cols={2}>
  <Card title="Voice Concierge (Pipecat + ElevenLabs)" icon="phone" href="/cookbook/voice-concierge">
    In Development · Phone agent that recalls caller history mid-call. STT → memory inject → LLM → TTS.
  </Card>
</CardGroup>

## B2B Agents

Outbound and inbound agents for business buyers and sellers.

<CardGroup cols={2}>
  <Card title="AI SDR" icon="handshake" href="/cookbook/b2b-sdr">
    In Development · Prospecting agent: research, personalize, sequence, book, with prospect memory across touches.
  </Card>

  <Card title="Salesforce: Enterprise Sales Assistant" icon="chart-line" href="/cookbook/b2b-salesforce">
    Live in Playground · Account-grounded sales assistant with opportunity history and CRM-aware recommendations.
  </Card>
</CardGroup>

## Personal AI Agents

Consumer-side personal agents. Strong individual user scoping; preferences and habits are the core memory.

<CardGroup cols={2}>
  <Card title="AI Companion" icon="heart" href="/cookbook/personal-ai-companion">
    Live in Playground · Conversational companion that learns preferences, communication style, and ongoing context.
  </Card>

  <Card title="AI Coach" icon="dumbbell" href="/cookbook/personal-ai-coach">
    In Development · Wellness coach with goal tracking, plan adherence memory, and session continuity.
  </Card>
</CardGroup>

## Choosing a recipe

Quick decision guide:

| If you're building for…            | Start with                                                                                                                                                                           |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| End-user support in a consumer app | [Uber: Customer Support](/cookbook/consumer-uber)                                                                                                                                    |
| Product discovery / commerce       | [Amazon: Shopping Assistant](/cookbook/consumer-amazon)                                                                                                                              |
| Internal helpdesk with escalation  | [Tier-1 → Tier-2 Escalation Cluster](/cookbook/support-tier-escalation)                                                                                                              |
| WhatsApp-first business comms      | One of the three WhatsApp recipes ([handoff](/cookbook/whatsapp-single-handoff), [campaign](/cookbook/whatsapp-single-campaign), [multi-WABA](/cookbook/whatsapp-multi-waba-shared)) |
| Phone / IVR replacement            | [Voice Concierge](/cookbook/voice-concierge)                                                                                                                                         |
| Outbound B2B prospecting           | [AI SDR](/cookbook/b2b-sdr)                                                                                                                                                          |
| Enterprise sales enablement        | [Salesforce: Enterprise Sales Assistant](/cookbook/b2b-salesforce)                                                                                                                   |
| Consumer companion / lifestyle app | [AI Companion](/cookbook/personal-ai-companion) or [AI Coach](/cookbook/personal-ai-coach)                                                                                           |

Don't see your shape? The patterns transfer. Start from the closest recipe, then check [Patterns](/patterns/overview) for cross-cutting techniques like scoping, replay ingestion, and graceful degradation.

## Stack you'll need

Every recipe runs on the Synap SDK plus one or more of:

* **Frameworks**: see [AI Integrations](/integrations/overview) for the full list (LangChain, OpenAI Agents, Vercel AI SDK, Mastra, Pipecat, LiveKit, etc.)
* **Vity**: see [Maximem Vity](/vity/overview) for end-user memory plugins (OpenClaw, more coming)
* **Concepts**: recipes link out to the [Concepts](/concepts/memory-scopes#clients-and-instances) section when scoping or memory architecture matters

<Note>
  **TypeScript prerequisite:** The JavaScript SDK wraps the Python SDK as a subprocess. Every TS recipe requires **Python 3.11+ on the host** and pins Next.js route handlers to `export const runtime = "nodejs"`. Edge Runtime, Cloudflare Workers, Bun, Deno Deploy, and Lambda Node-only runtimes are not supported. See [Installation → JavaScript / TypeScript SDK](/setup/installation#javascript-typescript-sdk).
</Note>

## Contributing

Built something Cookbook-worthy? Email **[support@maximem.ai](mailto:support@maximem.ai)** with the shape and we'll work it in. Recipes that get repeatedly requested become part of the docs.