[Integrations](https://spiral.ai/integrations) › [VS Code](https://spiral.ai/integrations/vscode) › [Orpheus TTS](https://spiral.ai/integrations/vscode/orpheus-tts)

# How to Use Orpheus TTS in VS Code

Orpheus TTS turns English scripts into expressive speech for narration and conversational replies. Inline cues such as <sigh> and <chuckle> add vocal reactions, while generation settings also affect speaking speed.

|  |  |
| --- | --- |
| Model | Orpheus TTS |
| Available through | fal |
| Category | Audio |
| Price | Each item in `text` adds $0.065. |
| Returns | audio |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Orpheus TTS in VS Code

- Read the README and use Orpheus TTS to narrate a 60-word English overview of what the project does. Verify every statement against the repository and keep command syntax out of the spoken script.
- Find the onboarding copy in this project. Use Orpheus TTS to create a short English welcome recording that explains the first task in plain language.
- Use Orpheus TTS to audition this line from our dialogue prototype: 'I thought I had it figured out. <sigh> Let me try again.' Save the recording beside the scene assets.
- Use Orpheus TTS to create two readings of the same 40-word English feature explanation from the changelog. Hold repetition_penalty at 1.2 and compare temperature 0.6 with 0.8; label the recordings for a listening review.
- Read the empty-state messages in the project and select three that need spoken equivalents. Rewrite each as one clear English sentence, then generate a separate recording with Orpheus TTS.

## How to set up Orpheus TTS in VS Code

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**: Use Add to VS Code on the console's Agents & MCP page, or run:

```bash
code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}'
```

2. **Sign in**: VS Code asks you to sign in when it first starts the server: sign in to Spiral and click Authorize. No API key. Run MCP: List Servers from the Command Palette to check that Spiral is running.

### Use the Spiral skill

1. **Send VS Code this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Orpheus TTS**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/orpheus-tts",
    "input": {
      "text": "I just found a hidden treasure in the backyard! <gasp> Check it out!"
    }
  }'
```

Then paste one of the prompts above: VS Code finds Orpheus TTS on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/vscode

## Orpheus TTS tools and prices

- [Orpheus TTS](https://spiral.ai/tools/fal/fal-ai/orpheus-tts) (fal): $0.065 per 1,000 characters of `text`. Rounded up to the next 1,000 characters, minimum 1,000.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| voice | tara, leah, jess, leo, dan, mia, zac, zoe | tara | Voice ID for the desired voice. |
| temperature | 0 to 2 | 0.7 | Temperature for generation (higher = more creative). |
| repetition_penalty | 1.1 to 2 | 1.2 | Repetition penalty (>= 1.1 required for stable generations). |

## What can you do with Orpheus TTS in VS Code?

Turn project documentation and interface copy into English narration with Orpheus TTS. A coding agent can prepare scripts from repository files and generate recordings for walkthroughs or dialogue prototypes.

### Product walkthrough narration

Turn a short English walkthrough script into a spoken explanation of one task, such as creating a report or finding a saved search.

### Story excerpt readings

Generate a spoken reading of an English story excerpt. Try a documented vocal cue where a character laughs, sighs, or gasps.

### Conversational assistant replies

Give short English assistant responses a spoken delivery, from answering a question to explaining a failed action.

### Audio learning summaries

Convert a concise lesson recap into English speech for listening practice or review away from a screen.

### Recurring spoken briefings

Have an agent prepare a short English update from verified information, then generate a recording for the daily or weekly briefing.

### Dialogue auditions

Render short dialogue lines separately to compare phrasing and vocal reactions before choosing a reading for a scene or prototype.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All VS Code guides](https://spiral.ai/integrations/vscode)

## Orpheus TTS in other agents

- [Amp](https://spiral.ai/integrations/amp/orpheus-tts)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/orpheus-tts)
- [Claude](https://spiral.ai/integrations/claude-desktop/orpheus-tts)
- [Claude Code](https://spiral.ai/integrations/claude-code/orpheus-tts)
- [Cline](https://spiral.ai/integrations/cline/orpheus-tts)
- [Codex](https://spiral.ai/integrations/codex/orpheus-tts)
- [Cursor](https://spiral.ai/integrations/cursor/orpheus-tts)
- [Devin](https://spiral.ai/integrations/devin/orpheus-tts)
- [dots](https://spiral.ai/integrations/dots/orpheus-tts)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/orpheus-tts)
- [Gemini](https://spiral.ai/integrations/gemini/orpheus-tts)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/orpheus-tts)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/orpheus-tts)
- [goose](https://spiral.ai/integrations/goose/orpheus-tts)
- [Grok](https://spiral.ai/integrations/grok/orpheus-tts)
- [Grok Build](https://spiral.ai/integrations/grok-build/orpheus-tts)
- [Hermes](https://spiral.ai/integrations/hermes/orpheus-tts)
- [Instinct](https://spiral.ai/integrations/instinct/orpheus-tts)
- [Manus](https://spiral.ai/integrations/manus/orpheus-tts)
- [Muse](https://spiral.ai/integrations/muse/orpheus-tts)
- [Muse Code](https://spiral.ai/integrations/muse-code/orpheus-tts)
- [n8n](https://spiral.ai/integrations/n8n/orpheus-tts)
- [Notion](https://spiral.ai/integrations/notion/orpheus-tts)
- [OpenClaw](https://spiral.ai/integrations/openclaw/orpheus-tts)
- [opencode](https://spiral.ai/integrations/opencode/orpheus-tts)
- [Perplexity](https://spiral.ai/integrations/perplexity/orpheus-tts)
- [Raycast](https://spiral.ai/integrations/raycast/orpheus-tts)
- [Windsurf](https://spiral.ai/integrations/windsurf/orpheus-tts)
- [Zapier](https://spiral.ai/integrations/zapier/orpheus-tts)

## More VS Code guides

- [Nova-3 Multilingual](https://spiral.ai/integrations/vscode/nova-3-multilingual)
- [Qwen Audio 3.0 TTS Flash](https://spiral.ai/integrations/vscode/qwen-audio-3-0-tts-flash)
- [Nova-3](https://spiral.ai/integrations/vscode/nova-3)
- [Qwen3 TTS 0.6B](https://spiral.ai/integrations/vscode/qwen3-tts-0-6b)
- [Mureka 9.5 Instrumental](https://spiral.ai/integrations/vscode/mureka-9-5-instrumental)
- [Qwen3 TTS 1.7B Clone Voice](https://spiral.ai/integrations/vscode/qwen3-tts-1-7b-clone-voice)

## Questions about Orpheus TTS in VS Code

**Can VS Code use Orpheus TTS?**

Yes. Add Spiral to VS Code as an MCP server, and VS Code can find and run Orpheus TTS like any built-in tool.

**How much does Orpheus TTS cost in VS Code?**

Each item in `text` adds $0.065. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your VS Code plan is separate.

**Do I need a fal account to use Orpheus TTS in VS Code?**

No. Spiral runs Orpheus TTS on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Orpheus TTS in VS Code?**

About two minutes: add the hosted server, then sign in.

**Does VS Code wait while Orpheus TTS runs?**

Orpheus TTS runs in the background. VS Code starts the run, checks on it and gives you the audio when it's ready.

**What is Orpheus TTS good at?**

Orpheus TTS suits English narration and conversational replies where phrasing and vocal expression matter. Useful starting points include spoken explainers, story excerpts, and assistant responses.

**Which language should I use with Orpheus TTS?**

Use English for the original Orpheus TTS release. Canopy Labs documents its multilingual releases separately, so their language coverage should not be assumed here.

**How do I add laughter or a sigh?**

Insert a supported cue directly into the spoken script, such as 'Well, that went differently. <sigh> Let's try again.' Documented cues include <laugh>, <chuckle>, <sigh>, <cough>, <sniffle>, <groan>, <yawn>, and <gasp>.

**Can I reliably command an exact emotion?**

Treat broad emotion labels cautiously: a Canopy collaborator said they did not work on the original released finetune. Use the documented vocal cues for specific reactions, and audition the result before relying on a particular emotional reading.

**Which settings affect speaking speed?**

Canopy documents that increasing temperature and repetition penalty makes speech faster. Change one setting at a time and compare the same script; keep repetition penalty at or above 1.1 for stability.

