What do you want to do?
4 use cases
-
Add a live talking face to a Python voice agent
Stream your agent's generated audio into a portrait to show a synced avatar.
- Openspline
- Content
- Intermediate
View prompt
Use the openspline repo (github.com/openspline/openspline) to add an avatar to the Python voice agent at <path-to-agent>. Use portrait <path-to-portrait.jpg> and pass the agent's PCM audio to avatar.stream with sample_rate=24000. Output the viewer URL and confirm the agent's audio plays once, not twice.
-
Run a local avatar demo on your own NVIDIA GPU
Install the GPU service and open a local demo at localhost:7860.
- Openspline
- Content
- Intermediate
View prompt
Use the openspline repo (github.com/openspline/openspline) to set up the local GPU service on <target-machine>. Run the install script and launch the demo, then confirm the demo answers at http://localhost:7860. Report the GPU model and whether the demo page loads.
-
Put a face on an OpenAI Realtime agent
Wrap an existing OpenAI Realtime connection so the avatar speaks its replies.
- Openspline
- Content
- Advanced
View prompt
Use the openspline repo (github.com/openspline/openspline) to add the OpenAIRealtime adapter to the agent in <path-to-agent>, keeping its existing event handler. Use portrait <path-to-portrait.jpg>. Confirm the speaker output is disabled so audio plays once, and report the viewer URL.
-
Add an avatar to a LiveKit voice agent
Attach an avatar to your AgentSession so it plays in your normal LiveKit frontend.
- Openspline
- Content
- Advanced
View prompt
Use the openspline repo (github.com/openspline/openspline) to attach an AvatarSession to the LiveKit agent in <path-to-agent>, using portrait <path-to-portrait.jpg>. Start the avatar before agent_session.start and confirm the avatar is visible in the room.
How to use Openspline
- Check you have what it needs: A portrait image of the face to animate, with rights to use it; Python 3.x or Node 20+ for the SDK; Either an OpenSpline Cloud API key or a Linux or WSL2 machine with an NVIDIA GPU.
- Open openspline/openspline on GitHub and read the README and license.
- Run
pip install openspline. - Set
OPENSPLINE_API_KEYon your backend, or run a local service as described in the Self Host section. - Create the client and open the avatar with
async with client.avatar("portrait.jpg", quality="low") as avatar:, then printavatar.viewer_url. - Call
await avatar.stream(agent.audio_stream(), sample_rate=24000)with your agent's PCM audio.
These steps come from our top use case, Add a live talking face to a Python voice agent, which also has a copy-paste agent prompt.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeAbout this repo
- Who it is forDevelopers building voice AI agents who want a live face on the agent, and teams that want to run avatar generation on their own GPU.
- Why it is hot
- LanguagePython
- Sourcegithub.com/openspline/openspline · Back to Hot repos
Requirements
- A portrait image of the face to animate, with rights to use it
- Python 3.x or Node 20+ for the SDK
- Either an OpenSpline Cloud API key or a Linux or WSL2 machine with an NVIDIA GPU
- An existing voice AI agent or a TTS provider that outputs PCM audio
Maintain Openspline? Add the Featured on Deduped badge
Paste this into your README:
[](https://dedupedai.com/use-cases/openspline-openspline/?ref=badge)
Questions about Openspline
What is Openspline?
OpenSpline is a Python and Node SDK that turns a portrait and generated audio into a synchronized talking avatar video, on OpenSpline Cloud or a self-hosted NVIDIA GPU. It is an open-source project on GitHub: https://github.com/openspline/openspline.
Who is Openspline for?
Developers building voice AI agents who want a live face on the agent, and teams that want to run avatar generation on their own GPU.
What can I do with Openspline?
4 use cases so far, for example: Add a live talking face to a Python voice agent; Run a local avatar demo on your own NVIDIA GPU; Put a face on an OpenAI Realtime agent. Each has steps and a copy-paste agent prompt.
What do I need to run Openspline?
A portrait image of the face to animate, with rights to use it; Python 3.x or Node 20+ for the SDK; Either an OpenSpline Cloud API key or a Linux or WSL2 machine with an NVIDIA GPU; An existing voice AI agent or a TTS provider that outputs PCM audio.
What are alternatives to Openspline?
Other hot AI repos in Content: Voice Studio, Anatomy, Comfy UI, Hyperframes, Earshot.
Is Openspline safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.