#01

🌟 Why Kwami

Ship one expressive companion instead of juggling separate widgets for audio, AI, and visuals.

#02

⚡ Quick Start

Install the package, run the playground, and point Kwami at any canvas.

#03

🧱 Architecture

Mind, Body, and Soul stay decoupled so teams can tweak logic, visuals, or vibe independently.

#04

🧠 Mind Layer

Define providers, enter an ElevenLabs key, and spin up conversations with one click.

#05

🫧 Body Layer

The WebGL blob reacts to FFT data, touch ripples, and pointer gestures in real time.

#06

💖 Soul Layer

Ten emotional traits steer prompts, voice tone, and animation states.

#07

🎮 Interaction Flow

Idle, listening, thinking, and speaking states keep the blob legible at a glance.

#08

🎨 Visual Styles

Pick gradients, glass, imagery, or videos and keep typography synced with palette shifts.

#09

🎵 Audio & Voice

Web Audio analysis drives spikes while ElevenLabs handles low-latency speech.

#10

🔌 Provider Architecture

Every vendor implements the same `connect / speak / listen / dispose` surface.

#11

🛠️ Customization & Config

Adjust spikes, time, skins, rotation, and emotional ranges with type-safe configs.

#12

👨‍💻 Developer Toolkit

Export GLB models, reuse Nuxt/Bun starters, or drop straight into any SPA.

#13

⚙️ Performance & Testing

60fps targets, Vitest suites, and strict TS settings keep experiments shippable.

#14

🚀 Use Cases

From DJ sets to wellness companions, upload any track and watch the blob respond.

#15

🌐 Connected Ecosystem

Kwami ties into kwami.io, qwami.io, and quami.io so one NFT companion spans Web2/Web3 workflows.

#16

💎 Ownership & Web3

Mint a Kwami on Solana and keep the blob's DNA hash synced with live configs.

#17

🔮 Roadmap

WebXR, multi-character scenes, physics, and plugins are already in flight.

#18

🎓 Learning Path

Follow the docs from Getting Started to Mind/Body/Soul deep dives within minutes.

#19

🤝 Community

Share shaders, providers, or docs PRs—everything lives in the open.

#20

🏢 Pro & Enterprise

Upgrade for white-labeling, premium providers, analytics, and dedicated support.

#21

🚀 Launch Your Companion

Fork the repo, remix the blob, and drop your own AI companion in minutes.