LiveKit Plugins Spatius

Agent Framework plugin for Spatius avatars.

See the Spatius documentation for Spatius account setup and avatar configuration.

Client-side rendering

Spatius avatars are rendered on the client instead of being sent as conventional server-rendered video. The avatar's LiveKit video track carries motion data in otherwise black frames, so a standard LiveKit video renderer will display a black screen. Your frontend must use the Spatius client SDK and LiveKit adapter to decode the track and render the avatar.

See the client integration guide and the reference frontend for a working implementation.

Installation

pip install livekit-plugins-spatius

Usage

from livekit.plugins import spatius

avatar = spatius.AvatarSession()
await avatar.start(session, room=ctx.room)

The plugin reads SPATIUS_API_KEY, SPATIUS_APP_ID, and SPATIUS_AVATAR_ID from the environment when constructor arguments are omitted. It defaults to the us-west Spatius region and composes the production endpoint URLs automatically.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

livekit_plugins_spatius-1.6.8.tar.gz (8.4 kB view details)

Uploaded Aug 3, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

livekit_plugins_spatius-1.6.8-py3-none-any.whl (8.6 kB view details)

Uploaded Aug 3, 2026 Python 3

File details

Details for the file livekit_plugins_spatius-1.6.8.tar.gz.

File metadata

Download URL: livekit_plugins_spatius-1.6.8.tar.gz
Upload date: Aug 3, 2026
Size: 8.4 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for livekit_plugins_spatius-1.6.8.tar.gz
Algorithm	Hash digest
SHA256	`ed25051c42c8e37f42946366c6d433351800e6b8742e9463d1367a95d93d4174`
MD5	`178c29b3f4718d92d24d00a25fa4754c`
BLAKE2b-256	`8e19cf43764e490d8fe73af464b1677b9df02b5fccfca97fbfdb63b4a6854493`

See more details on using hashes here.

Provenance

The following attestation bundles were made for livekit_plugins_spatius-1.6.8.tar.gz:

Publisher: publish.yml on livekit/agents

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: livekit_plugins_spatius-1.6.8.tar.gz
- Subject digest: ed25051c42c8e37f42946366c6d433351800e6b8742e9463d1367a95d93d4174
- Sigstore transparency entry: 2335843552
- Sigstore integration time: Aug 3, 2026
Source repository:
- Permalink: livekit/agents@c4c303a34d06c64d06851cc2762265f98eb29ced
- Branch / Tag: refs/heads/main
- Owner: https://github.com/livekit
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@c4c303a34d06c64d06851cc2762265f98eb29ced
- Trigger Event: pull_request