whatisgithub

What is nyxclaw?

myned-ai/nyxclaw — explained in plain English

Analysis updated 2026-05-18

2RustAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A self-hosted Rust server that gives any AI agent a real-time animated, lip-synced avatar on your phone, with no GPU and no cloud relay required.

Mindmap

mindmap
  root((NyxClaw))
    What it does
      Animated avatar for AI agents
      Lip sync from audio
    Tech stack
      Rust server
      ONNX on CPU
      Cloudflare Tunnel
    Use cases
      Talking avatar on phone
      Local voice pipeline
      Rich content display
    Audience
      Developers
      Self hosters
    Privacy
      No cloud relay
      No telemetry
      Encrypted pairing

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give a self-hosted AI agent a talking, lip-synced avatar you view on your phone.

USE CASE 2

Run a fully local voice pipeline so no audio ever leaves your machine.

USE CASE 3

Pair a phone to your AI agent's server over an encrypted tunnel with no port forwarding.

USE CASE 4

Let an AI agent show rich content like links or tables on the phone while it speaks.

What is it built with?

RustONNXDockerWebSocketCloudflare Tunnel

How does it compare?

myned-ai/nyxclaw1lystore/pay-dcpcallmealphabet/fastcp
Stars222
LanguageRustRustRust
Setup difficultymoderatemoderateeasy
Complexity3/53/51/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs Docker or the install script plus a running OpenClaw or ZeroClaw backend to connect to.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

NyxClaw is a self-hosted server, built in Rust, that gives any AI agent a real-time animated avatar with lip-sync and voice. You run it on your own machine alongside your AI agent, and it connects to a companion mobile app that shows the avatar's face. When the AI speaks, the avatar's mouth moves in sync, it also keeps breathing and blinking during processing gaps rather than freezing. The animation system works by converting audio into 52 ARKit blendshapes, a standard format for facial animation used in phone cameras, at 30 frames per second, all on CPU with no GPU required. You can interrupt the avatar mid-sentence and both the AI and the audio playback cancel within about 128 milliseconds. Two voice pipelines are available. The OpenAI Voice pipeline uses OpenAI's Realtime API for speech-to-text and text-to-speech, so audio goes through OpenAI's servers. The Local Voice pipeline uses faster-whisper with Silero VAD for speech recognition and Piper VITS ONNX for speech synthesis, so nothing leaves your machine. Privacy and security are central to the design. The server pairs with your phone via QR code using Ed25519 cryptographic authentication, and the connection travels over an automatically provisioned encrypted WebSocket tunnel with no port forwarding or certificates needed. There is no cloud relay and no telemetry. NyxClaw currently supports two AI agent backends, OpenClaw and ZeroClaw, with optional patches that enable richer behavior such as splitting responses into spoken audio and visual content shown on the phone. The mobile app is available on Google Play. The full README is longer than what was provided.

Copy-paste prompts

Prompt 1
How do I install NyxClaw with Docker and connect it to my OpenClaw or ZeroClaw agent?
Prompt 2
Help me set up the local voice pipeline in NyxClaw so no audio leaves my machine.
Prompt 3
Explain how NyxClaw's Ed25519 device pairing and encrypted tunnel work.
Prompt 4
Show me how to apply the NyxClaw avatar patch so my agent can send rich content separately from speech.

Frequently asked questions

What is nyxclaw?

A self-hosted Rust server that gives any AI agent a real-time animated, lip-synced avatar on your phone, with no GPU and no cloud relay required.

What language is nyxclaw written in?

Mainly Rust. The stack also includes Rust, ONNX, Docker.

What license does nyxclaw use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is nyxclaw to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is nyxclaw for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.