embed-avatar-assistant
/embed-avatar-assistant
Dodaje do strony pływający asystent-awatar 3D z jednym tagiem skryptu lub pakietem npm, a potem steruje nim z kodu strony.
- Autor
- nirholas ↗
- Repozytorium
- three.ws ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 1
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
Co robi i kiedy
Dodaje do strony pływający asystent-awatar 3D z jednym tagiem skryptu lub pakietem npm, a potem steruje nim z kodu strony.
Oryginalny opis (EN)
Add the three.ws 3D avatar assistant widget (floating launcher, chat mode, speak mode) to any website with one script tag or the @three-ws/assistant npm package, then drive it from page code. Use when a user wants an animated avatar chatbot or a talking avatar on a site.
Jak działa
- Install
- Options (config key or data- attribute)
- Page API
- Worked example
Podgląd SKILL.md
---
name: embed-avatar-assistant
description: Add the three.ws 3D avatar assistant widget (floating launcher, chat mode, speak mode) to any website with one script tag or the @three-ws/assistant npm package, then drive it from page code. Use when a user wants an animated avatar chatbot or a talking avatar on a site.
---
# Embed the three.ws avatar assistant
The widget is a small host-side loader. The avatar, chat and speech run in an iframe hosted on three.ws (`/assistant-frame`), so the page never sees model keys. Chat uses the platform's free model chain by default (visitors can switch to their own Groq or OpenRouter key); speak mode uses browser text-to-speech with no model.
## Install
One tag, no build:
```html
<script src="https://three.ws/assistant/v1.js" async
data-avatar="/avatars/selfie-girl.glb"
data-name="Atelier AI"
data-greeting="Ask anything about Atelier."
data-context="Atelier is a design studio for 3D artists."
data-bg="transparent"
data-accent="#f97316"></script>
```
Or npm:
```bash
npm install @three-ws/assistant
```
```js
import ThreeAssistant from '@three-ws/assistant';
ThreeAssistant.init({ avatar: '/avatars/selfie-girl.glb', name: 'Atelier AI', mode: 'both' });
```
## Options (config key or `data-*` attribute)
- `avatar`: an avatar id, `/avatars/*.glb`, or a GLB, GLTF or VRM URL on an allow-listed host (three.ws, R2, Ready Player Me). `agent`: a three.ws agent id whose avatar is used instead.
- `mode`: `chat`, `speak` or `both` (default). `name` (60 chars), `greeting` (200), `context` (500, what the chatbot should know about the site).
- `bg`: `transparent` (default), a `#hex`, a preset (`ember`, `ocean`, `violet`, `forest`, `dusk`, `slate`) or `gradient:#a,#b,angle`. `accent`: `#hex`. `position`: `right` or `left`.
- `voice="false"` starts muted, `badge="false"` hides the attribution badge, `open` starts open, `origin` overrides the frame host (config key only), `data-manual` stops auto-mount on the one-tag build.
Invalid values fall back to a safe default inside the frame.
## Page API
```js
ThreeAssistant.init(config); // replaces any existing instance
ThreeAssistant.open(); ThreeAssistant.close(); ThreeAssistant.toggle();
ThreeAssistant.say('Welcome to the sale!'); // opens and speaks the line
ThreeAssistant.setMode('speak'); // only when mounted with mode 'both'
ThreeAssistant.destroy();
```
Named exports: `init`, `say`, `createAssistant({ origin })`, `VERSION`. Events fire on `window` as `three-assistant` with `detail.type` of `ready`, `open`, `close`, `message`, `speak:start`, `speak:end` or `error`.
## Worked example
```js
window.addEventListener('three-assistant', (e) => {
if (e.detail.type === 'message') console.log(e.detail.payload.role, e.detail.payload.content);
});
ThreeAssistant.init({ avatar: '/avatars/selfie-girl.glb', name: 'Shop Guide', context: 'We sell ceramic mugs.' });
document.querySelector('#sale').addEventListener('click', () => ThreeAssistant.say('Mugs are 20 percent off today.'));
```
Keep `context` to public site facts; it is sent to the chat model.
Wersje
W bazie nie ma innych skilli o nazwie embed-avatar-assistant.
Migawka bazy z 13.11.2026 · wersja paczki df14badcb755 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100embed-assistant-widget
Generuje gotowy do wklejenia osadzony czat z awatarem 3D three.ws, z tagiem skryptu, adresem ramki i fragmentem inicjalizacji. - 100embed-three-ws-avatar
Osadza żywy, animowany awatar 3D three.ws na stronie przez komponent agent-3d, w tym sterowanie animacjami i nastrojami awatara z kodu strony. - 100talking-avatar-skill
Tworzy lekką aplikację do rozmowy głosowej z awatarem postaci, z obrazu lub opisu, z synchronizacją ust z dźwiękiem. - 100liveavatar-integrate
Prowadzi przez integrację LiveAvatar od początku do końca: ocenia stos użytkownika, rekomenduje ścieżkę (Embed, FULL Mode, LITE) i prowadzi wdrożenie awatara w czasie rzeczywistym. - 100simli
Dodaje do agenta głosowego lub aplikacji webowej awatar wideo z synchronizacją ust przez Simli, w tym własny awatar z zdjęcia. - 100seer-embed
Dodaje nowy widget embed Seer renderowany inline w markdownie przez składnię tagów: schemat, komponent, rejestracja i codegen backendu.