[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Kokoro Italian](https://spiral.ai/integrations/opencode/kokoro-italian)

# How to Use Kokoro Italian in opencode

Kokoro Italian turns Italian scripts into spoken audio for lessons, explainers, and narration. Give it complete passages: very short lines can sound weaker, while long passages can rush.

|  |  |
| --- | --- |
| Model | Kokoro Italian |
| Available through | fal |
| Category | Audio |
| Price | Each item in `prompt` adds $0.026. |
| Returns | audio |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Kokoro Italian in opencode

- Read this project's README and draft an Italian introduction explaining its purpose and first useful task. Generate the narration with Kokoro Italian, dividing the script into complete passages and keeping commands out of the spoken text.
- Use the latest changelog entry to write an Italian release briefing focused on user-visible changes. Generate it with Kokoro Italian as separate complete passages for features and fixes.
- Review the onboarding screens in this project and write an Italian narration for a walkthrough. Use Kokoro Italian to generate one complete passage per task, with no production notes in the spoken script.
- Find the tutorial scripts in this repository and prepare Italian narration for the first lesson. Generate it with Kokoro Italian, splitting long explanations at sentence boundaries and preserving the technical meaning.
- Review the Italian help content in this project and choose one explanation for an audio preview. Generate a normal reading and a slightly slower reading with Kokoro Italian so I can compare the pace.

## How to set up Kokoro Italian in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 Kokoro Italian**: 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/kokoro/italian",
    "input": {
      "prompt": "Ogni giorno è una nuova opportunità per scrivere la tua storia. Rendila straordinaria!",
      "voice": "if_sara"
    }
  }'
```

Then paste one of the prompts above: opencode finds Kokoro Italian on Spiral, shows the price and runs it.

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

## Kokoro Italian tools and prices

- [Kokoro TTS (Italian)](https://spiral.ai/tools/fal/fal-ai/kokoro/italian) (fal): $0.026 per 1,000 characters of `prompt`. Rounded up to the next 1,000 characters, minimum 1,000.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| speed | 0.1 to 5 | 1 | Speed of the generated audio. Default is 1.0. |

## What can you do with Kokoro Italian in opencode?

Create Italian narration from project documentation, release notes, and tutorial scripts. Your coding agent can prepare complete passages and organize the recordings around the tasks they explain.

### Italian listening lessons

Narrate a short explanation followed by example sentences. Keep related examples together instead of generating every word separately.

### Article audio editions

Turn an Italian article into a spoken edition, dividing the script into complete passages for review and assembly.

### Product walkthrough narration

Create Italian narration for a screen recording, with one complete passage for each task the viewer needs to learn.

### Museum audio guides

Produce an Italian explanation for each exhibit, keeping the spoken script separate from labels and production notes.

### Recurring audio briefings

Convert a prepared Italian news or operations summary into a spoken briefing, with separate passages for distinct topics.

### Narrated training material

Read Italian training explanations aloud, dividing longer lessons into sections that can be reviewed individually.

### Event announcements

Create Italian audio covering arrival instructions, the agenda, and venue information. Combine related details into complete announcements.

## Overview

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

## Kokoro Italian in other agents

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

## More opencode guides

- [Kokoro Hindi](https://spiral.ai/integrations/opencode/kokoro-hindi)
- [Kokoro Japanese](https://spiral.ai/integrations/opencode/kokoro-japanese)
- [Kokoro French](https://spiral.ai/integrations/opencode/kokoro-french)
- [Kokoro Mandarin Chinese](https://spiral.ai/integrations/opencode/kokoro-mandarin-chinese)
- [Kokoro British English](https://spiral.ai/integrations/opencode/kokoro-british-english)
- [Kokoro TTS Spanish](https://spiral.ai/integrations/opencode/kokoro-tts-spanish)

## Questions about Kokoro Italian in opencode

**Can opencode use Kokoro Italian?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Kokoro Italian like any built-in tool.

**How much does Kokoro Italian cost in opencode?**

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

**Do I need a fal account to use Kokoro Italian in opencode?**

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

**How long does it take to set up Kokoro Italian in opencode?**

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

**Does opencode wait while Kokoro Italian runs?**

Kokoro Italian runs in the background. opencode starts the run, checks on it and gives you the audio when it's ready.

**What should I use Kokoro Italian for?**

Use it to turn Italian scripts into narration. Practical applications include spoken lessons, article readings, product explainers, and audio announcements.

**How long should each passage be?**

The maker recommends roughly 100–200 model tokens for most voices. Treat that as a quality target rather than a word count or a hosted request limit.

**Why can a short phrase sound weaker?**

The maker flags weaker results on utterances below roughly 10–20 tokens. Try combining related lines into a complete passage, then separating the audio afterward if needed.

**How do I reduce rushed narration?**

Split long passages into shorter sections and try a slower speaking speed. The maker specifically warns about rushing above roughly 400 model tokens.

**What sample rate does Kokoro use?**

Kokoro's reference implementation uses 24,000 Hz audio. Use that as the upstream reference when planning audio editing, and inspect the actual returned file before combining recordings.

