# devii-avatar
The animated assistant avatar (a vendored md-clippy character). It is a controller element: it
renders no markup of its own but drives the on-screen character, which can speak, animate, and move.
The `DeviiTerminal` controller creates one as `#devii` and links it to the terminal.
Source: `static/js/devii/devii-avatar.js`.
## Attributes
| Attribute | Type | Default | Description |
|---|---|---|---|
| `character` | string | `Clippy` | Which character to display. |
| `tts` | boolean | off | Enable text-to-speech. |
| `autoshow` | boolean | off | Show the character on connection. |
## Methods
| Method | Description |
|---|---|
| `execute(action, args)` | Run an avatar action: `show`, `hide`, `speak`, `play_animation`, `random_animation`, `move_to`, `gesture_at`, `stop`, `switch_character`, `list_animations`, `list_characters`, `get_viewport`. |
| `ask(text)` | Send a prompt to the connected assistant. |
## Usage
```html
<devii-avatar character="Clippy" autoshow></devii-avatar>
```
Live example - shows the avatar and plays an animation