DEMO_SCRIPT.md

# GrandVoice Demo Script

Target length: 60 to 90 seconds.

## Scene 1: Intro

"This is GrandVoice, a multilingual voice companion and translator for elderly people, small kids, and families."

Show the app home screen.

## Scene 2: Bring your own key

"Because this is a public Space, GrandVoice does not use one shared API key. Each visitor can create a free Groq key and paste it here, so the app does not fail when one shared key hits rate limits."

Show the API key box.

## Scene 3: Elderly companion

Choose:

- Companion: Caring Companion
- Language: English

Type:

```text
I feel lonely today.
```

Say:

"The caring companion gives a short, warm answer and speaks it aloud."

Show the animated avatar while it replies.

## Scene 4: Repeat-send fix

Change companion to:

```text
Wise Elder
```

Do not type anything new. Click Send again.

Say:

"This was one of the important fixes. If you change the companion and press Send again, GrandVoice reuses the last message and gives a new answer instead of silently doing nothing."

## Scene 5: Kid story mode

Choose:

```text
Story Companion
```

Type:

```text
Start a story about a magical forest.
```

Say:

"For small kids, Story Companion makes the child the hero and gives two choices."

## Scene 6: Translation

Open Translator.

Translate from English to Telugu, Hindi, Tamil, Arabic, Japanese, or Mandarin.

Type:

```text
Please take this medicine twice a day.
```

Say:

"The translator is designed to output the selected language in its native script."

## Scene 7: Trace and Codex

Return to Voice Companion and click **Download trace**.

Say:

"The project also includes a trace download for sharing examples on the Hub, plus Codex notes explaining how Codex helped fix reliability, improve the UI, and prepare the Space for the hackathon."