feat: Spatius avatar plugin

livekit-agents/pyproject.toml

@@ -121,6 +121,7 @@ slng = ["livekit-plugins-slng>=1.6.6"]
 soniox = ["livekit-plugins-soniox>=1.6.6"]
 speechify = ["livekit-plugins-speechify>=1.6.6"]
 speechmatics = ["livekit-plugins-speechmatics>=1.6.6"]
+spatius = ["livekit-plugins-spatius>=1.6.6"]
 spitch = ["livekit-plugins-spitch>=1.6.6"]
 tavus = ["livekit-plugins-tavus>=1.6.6"]
 trugen = ["livekit-plugins-trugen>=1.6.6"]

livekit-plugins/livekit-plugins-spatius/README.md

@@ -0,0 +1,37 @@
+# LiveKit Plugins Spatius
+
+Agent Framework plugin for [Spatius](https://www.spatius.ai) avatars.
+
+See the [Spatius documentation](https://docs.spatius.ai) 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](https://docs.spatius.ai/livekit-agents/client) and
+the [reference frontend](https://github.com/spatius-ai/spatius-avatar-demo/tree/main/platform-integrations/livekit-agents-demo/livekit-agents-reference-demo/frontend)
+for a working implementation.
+
+## Installation
+
+```bash
+pip install livekit-plugins-spatius
+```
+
+## Usage
+
+```python
+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.

livekit-plugins/livekit-plugins-spatius/livekit/plugins/spatius/__init__.py

@@ -0,0 +1,39 @@
+# Copyright 2026 LiveKit, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Spatius avatar plugin for LiveKit Agents."""
+
+from spatius import AudioFormat
+
+from .avatar import AvatarSession, SpatiusException
+from .version import __version__
+
+__all__ = [
+    "AudioFormat",
+    "AvatarSession",
+    "SpatiusException",
+    "__version__",
+]
+
+from livekit.agents import Plugin
+
+from .log import logger
+
+
+class SpatiusPlugin(Plugin):
+    def __init__(self) -> None:
+        super().__init__(__name__, __version__, __package__, logger)
+
+
+Plugin.register_plugin(SpatiusPlugin())