Install VAssist
Desktop, Android, and extension releases are published on GitHub Releases. Browser package support is under development and is not published to npm yet.
Not sure yet?
The live demo runs in your browser and shows the full interface with no install required.
Choose your platform
Desktop app
Windows, macOS, and Linux. Full local AI, screen share, and tray support.
Use VAssist as a package
The @vassist/embed and @vassist/react packages are currently available only as Bun workspaces inside the VAssist repository. They are not published on npm, so npm install commands for these package names will not work yet. We will add installation instructions when a public release is available.
Recommended reading order if you are embedding VAssist:
- Package integration: choose
@vassist/embedvs@vassist/react, pick an entry point, and decide whether requests stay in the browser or move to a host bridge. - @vassist/embed reference: imperative mount/update/remove helpers, custom element usage, runtime controls, snapshots, storage, and resource loading.
- @vassist/react reference: React components, reactive config props,
customizations, and host control from React. - Configuration reference: every supported config field, settings target ID, bridge type, branding option, and hook.
If browser code must not hold vendor credentials, use providers.mode: "host-managed" together with transport.mode: "host-bridge" so your backend or native host owns AI, TTS, and STT requests. The Decision API's built-in connection check can also use the host bridge.
Requirements
| Version | What you need |
|---|---|
| Desktop | Windows, macOS, or Linux |
| Android | Any Android phone or tablet |
| Extension | Chrome or another Chromium-based browser |
Install on desktop
- Go to the latest release on GitHub.
- Download the file matching your OS (Windows, macOS, or Linux).
- Open it and follow the install steps your system shows.
- Launch VAssist. The setup wizard runs on first launch.
Install on Android
- Open the latest release on your phone (or transfer the APK to it).
- Download the
.apkfile. - Open it. Android will ask you to confirm installing from an unknown source. Allow it.
- Launch VAssist from your app drawer.
Live wallpaper setup
Do the main app setup before enabling the Android live wallpaper. The wallpaper reads settings from the app, so it needs them to be saved first.
Install the browser extension
The extension isn't on the Chrome Web Store yet, so you install it manually:
- Download the latest extension zip from GitHub Releases.
- Unzip it somewhere permanent (don't delete it after installing).
- Open
chrome://extensionsin Chrome. - Enable Developer mode (top-right toggle).
- Click Load unpacked and select the unzipped folder.
- Pin the extension icon for quick access.
Chrome AI features
Some extension features use Chrome's built-in AI (Gemini Nano). Those require a recent Chrome build and specific flags. The setup wizard will walk you through it if they're needed.
After installing
VAssist opens the setup wizard on first launch. That's where you choose your AI provider, voice options, and Live Assistant mode. See the setup guide →.
Building from source
See the project README and CONTRIBUTING guide.