Examples 2.0

.github/workflows/lint.yml

@@ -0,0 +1,18 @@
+name: Lint
+on: [pull_request]
+jobs:
+  ruff:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/ruff-action@v3
+
+  prettier:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+      - run: npm ci
+      - run: npx prettier . --check

.gitignore

@@ -12,6 +12,12 @@ __pycache__
 
 # dependencies
 node_modules
+**/package-lock.json
+!/package-lock.json
+pnpm-lock.yaml
+yarn.lock
+poetry.lock
+Pipfile.lock
 
 # IDEs and editors
 /.idea
@@ -34,10 +40,13 @@ node_modules
 /connect.lock
 /coverage
 /libpeerconnection.log
-npm-debug.log
-yarn-error.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
 testem.log
 /typings
+*.pem
 
 # System Files
 .DS_Store
@@ -46,7 +55,30 @@ Thumbs.db
 # env
 .env*
 !.env.example
-venv
+venv/
+.venv/
 
 # formatters
 .ruff_cache
+
+# skills files
+.agents/
+skills-lock.json
+.claude/
+.kiro/
+
+# next files
+**/.next/
+**/next-env.d.ts
+**/out/
+**/build/
+**/.vercel/
+**/.pnp
+**/.pnp.*
+**/.yarn/*
+!**/.yarn/patches
+!**/.yarn/plugins
+!**/.yarn/releases
+!**/.yarn/versions
+**/coverage/
+*.tsbuildinfo

DESIGN.md

@@ -0,0 +1,30 @@
+# Design Guidelines
+
+Follow these conventions when building example UIs.
+
+## Layout
+
+- Use a single centered column (`max-w-2xl`, `mx-auto`, `px-6`)
+- Keep the layout flat — avoid nested cards, panels, or bordered containers
+- Use spacing (`mt-*`, `space-y-*`) and typography to separate sections, not boxes
+- One control area, one content area — keep everything else unboxed
+
+## Styling
+
+- Neutral color palette for text and borders (`text-neutral-900`, `text-neutral-500`, `border-neutral-200`)
+- White background (`bg-white`)
+- No decorative styles: no gradients, heavy shadows, oversized rounded cards, ornamental icons
+- Buttons: `rounded-md`, `px-4 py-2`, `text-sm font-medium`
+- Small muted text for labels and status: `text-xs text-neutral-400`
+
+## Components
+
+- Prefer preloaded components from `components/ui/` when available
+- Avoid adding custom UI components unless strictly required
+- Render interactive components (waveforms, visualizations) inline without extra wrapper containers
+
+## Principles
+
+- Prioritize correctness and reliability over styling
+- Keep it minimal and utilitarian
+- Compact spacing, neutral colors, no decorative hero/nav elements

README.md

@@ -4,62 +4,83 @@
   </a>
 </p>
 
-This collection of demos and projects showcases the ElevenLabs API and how you can start building next generation AI audio apps with it. Whether you're looking to integrate text-to-speech into your website, create dubbed content, or explore advanced conversational applications, you'll find valuable resources here.
+Prompt-driven ElevenLabs examples for text-to-speech and speech-to-text. Each project includes:
 
-## 🚀 Featured Projects
+- `PROMPT.md` — instructions for agent-driven generation
+- `template/` — starter files copied before generation
+- `example/` — the generated, runnable example with its own `README.md`
 
-### Conversational AI Demos
-These projects offer practical examples of building real-time, voice-driven applications with rich interactivity.
+> The legacy `examples/` folder is being deprecated and can be ignored for new work.
 
-### Text-to-Speech (TTS) Demos
-- **Standard TTS Demo**: A straightforward implementation of our core TTS functionality.
-- **TTS WebSocket Demo with Latency Measurement**: Explore real-time text-to-speech with performance metrics.
+## Current examples
 
-### Native Mac App (Open Source)
-A fully open-source native Mac application that brings ElevenLabs to your desktop. Written by Claude 3.5 and Cursor.
+- [Text-to-Speech Quickstart (TypeScript)](text-to-speech/typescript/quickstart/example/README.md) - Generate an MP3 from text with the ElevenLabs JS SDK.
+  - [Text-to-Speech Quickstart (Python)](text-to-speech/python/quickstart/example/README.md) - Generate an MP3 from text with the ElevenLabs Python SDK.
+  - [Speech-to-Text Quickstart (TypeScript)](speech-to-text/typescript/quickstart/example/README.md) - Transcribe local audio files with Scribe v2.
+  - [Speech-to-Text Quickstart (Python)](speech-to-text/python/quickstart/example/README.md) - Transcribe local audio files with Scribe v2 using Python.
+- [Real-Time Speech-to-Text (Next.js)](speech-to-text/nextjs/realtime/example/README.md) - Live microphone transcription with VAD in a Next.js app.
 
-### Sound Effects Generation
-Unleash your creativity with our sound effects generation demo. Create custom audio landscapes for your projects!
+## Generate examples from prompts
 
-### AudioNative React Demo
-Embed ElevenLabs' text-to-speech capabilities directly into your React-based websites. This demo shows you how to seamlessly integrate our technology for a native-like audio experience.
+The general prompt-runner workflow is in `scripts/generate-examples.sh` and is exposed as:
 
-### Dubbing API Demo
-Discover how to use our Dubbing API to create multilingual content effortlessly. Perfect for content creators and localization teams!
+```bash
+pnpm run generate
+```
 
-### Pronunciation Dictionaries
-Learn how to work with pronunciation dictionaries to fine-tune the output of our voice models.
+### Prerequisites
 
+- `pnpm`
+- `claude` CLI
 
-## 🛠 Getting Started
+Install root dependencies first:
 
-To get started with these examples:
+```bash
+pnpm install
+```
 
-1. Clone this repository
-2. Navigate to the project you're interested in
-3. Follow the project-specific README for setup instructions
+### Usage
 
-For detailed API documentation and guides, visit our [Developer Docs](https://elevenlabs.io/docs/api-reference/getting-started).
+Run all example prompts:
 
-## 🤝 Contributing
+```bash
+pnpm run generate
+```
 
-We welcome contributions from the community! Before you start:
+Run only one example:
 
-1. Install the pre-commit hook:
-   ```
-   pip install pre-commit
-   pre-commit install
-   ```
-2. Check out our [Contributing Guidelines](CONTRIBUTING.md) for more information on how to submit pull requests, report issues, and suggest improvements.
+```bash
+pnpm run generate speech-to-text/nextjs/realtime
+```
 
-## 📚 Learn More
+Optional flags:
+
+```bash
+pnpm run generate -t 1200                     # timeout per prompt in seconds (default: 600)
+pnpm run generate -m opus                     # model selection (default: sonnet)
+pnpm run generate -v                          # verbose output
+pnpm run generate -m opus -t 1200 -v          # combine flags
+```
+
+## Try an example directly
+
+Each example has an `example/` folder with a README containing setup and run instructions. See the links in [Current examples](#current-examples) above.
+
+## Contributing
+
+We welcome contributions from the community. Install the pre-commit hook before submitting:
+
+```bash
+pip install pre-commit
+pre-commit install
+```
+
+## Learn more
 
 - [ElevenLabs Developer Docs](https://elevenlabs.io/docs/api-reference/getting-started)
 - [API Reference](https://api.elevenlabs.io/docs)
 - [ElevenLabs app](https://elevenlabs.io/)
 
-## 📄 License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+## License
 
----
+This project is licensed under the MIT License. See [LICENSE](LICENSE) for details.

examples/ElevenLabs Mac Helper app/ElevenLabsTTS/Assets.xcassets/AccentColor.colorset/Contents.json

@@ -1,11 +1,11 @@
 {
-  "colors" : [
+  "colors": [
     {
-      "idiom" : "universal"
+      "idiom": "universal"
     }
   ],
-  "info" : {
-    "author" : "xcode",
-    "version" : 1
+  "info": {
+    "author": "xcode",
+    "version": 1
   }
 }

examples/ElevenLabs Mac Helper app/ElevenLabsTTS/Assets.xcassets/AppIcon.appiconset/Contents.json

@@ -1,68 +1,68 @@
 {
-  "images" : [
+  "images": [
     {
-      "filename" : "elevenlogo-4.png",
-      "idiom" : "mac",
-      "scale" : "1x",
-      "size" : "16x16"
+      "filename": "elevenlogo-4.png",
+      "idiom": "mac",
+      "scale": "1x",
+      "size": "16x16"
     },
     {
-      "filename" : "elevenlogo16@2x.png",
-      "idiom" : "mac",
-      "scale" : "2x",
-      "size" : "16x16"
+      "filename": "elevenlogo16@2x.png",
+      "idiom": "mac",
+      "scale": "2x",
+      "size": "16x16"
     },
     {
-      "filename" : "elevenlogo-3.png",
-      "idiom" : "mac",
-      "scale" : "1x",
-      "size" : "32x32"
+      "filename": "elevenlogo-3.png",
+      "idiom": "mac",
+      "scale": "1x",
+      "size": "32x32"
     },
     {
-      "filename" : "elevenlogo32@2x.png",
-      "idiom" : "mac",
-      "scale" : "2x",
-      "size" : "32x32"
+      "filename": "elevenlogo32@2x.png",
+      "idiom": "mac",
+      "scale": "2x",
+      "size": "32x32"
     },
     {
-      "filename" : "elevenlogo.png",
-      "idiom" : "mac",
-      "scale" : "1x",
-      "size" : "128x128"
+      "filename": "elevenlogo.png",
+      "idiom": "mac",
+      "scale": "1x",
+      "size": "128x128"
     },
     {
-      "filename" : "elevenlogo128@2x.png",
-      "idiom" : "mac",
-      "scale" : "2x",
-      "size" : "128x128"
+      "filename": "elevenlogo128@2x.png",
+      "idiom": "mac",
+      "scale": "2x",
+      "size": "128x128"
     },
     {
-      "filename" : "elevenlogo-1.png",
-      "idiom" : "mac",
-      "scale" : "1x",
-      "size" : "256x256"
+      "filename": "elevenlogo-1.png",
+      "idiom": "mac",
+      "scale": "1x",
+      "size": "256x256"
     },
     {
-      "filename" : "elevenlogo256@2x.png",
-      "idiom" : "mac",
-      "scale" : "2x",
-      "size" : "256x256"
+      "filename": "elevenlogo256@2x.png",
+      "idiom": "mac",
+      "scale": "2x",
+      "size": "256x256"
     },
     {
-      "filename" : "elevenlogo-2.png",
-      "idiom" : "mac",
-      "scale" : "1x",
-      "size" : "512x512"
+      "filename": "elevenlogo-2.png",
+      "idiom": "mac",
+      "scale": "1x",
+      "size": "512x512"
     },
     {
-      "filename" : "elevenlogo512@2x.png",
-      "idiom" : "mac",
-      "scale" : "2x",
-      "size" : "512x512"
+      "filename": "elevenlogo512@2x.png",
+      "idiom": "mac",
+      "scale": "2x",
+      "size": "512x512"
     }
   ],
-  "info" : {
-    "author" : "xcode",
-    "version" : 1
+  "info": {
+    "author": "xcode",
+    "version": 1
   }
 }

examples/ElevenLabs Mac Helper app/ElevenLabsTTS/Assets.xcassets/Contents.json

@@ -1,6 +1,6 @@
 {
-  "info" : {
-    "author" : "xcode",
-    "version" : 1
+  "info": {
+    "author": "xcode",
+    "version": 1
   }
 }