Is bloub still maintained?

Yes, active. Last change 3 months ago. Latest release v0.1.1, 3 months ago.

New, little track record. 2k stars, 3 months old. Look at the code and the owner before running it.

Reading the repo

Opening the box…

How to install on macOS

jeremy-prt/bloub

SVG recreation of the x.ai bot avatar. One shape morphing through 14 states, measured off the reference video frame by frame.

Node.jsVite#animation#avatar#morphing#svg

Before you start

Is it free?: YesOpen source (MIT).
Still maintained?: Yes, activeLast change 3 months ago. Latest release v0.1.1, 3 months ago.
Can I trust it?: New, little track record2k stars, 3 months old. Look at the code and the owner before running it.

Difficulty: Easy
Time: about 5 min
Stars: ★ 1,968
Activity: Updated 3 months ago
Got it running: 1 person

Saved setup from 6 h ago

Will it work on macOS?

Yes, it runs on macOS

You'll build it yourself with Node.js.

Your system

macOS Windows Linux

Start here

Website ↗bloub.vercel.appThe project's own site.

5 steps on macOS

Download setup.sh

Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.

Clone the repository

Needs Git: xcode-select --install

git clone https://github.com/jeremy-prt/bloub.git
cd bloub

Install the required runtimes

Node.js 24

# needs nvm: brew install nvm (or https://github.com/nvm-sh/nvm)
nvm install 24

3
Install dependencies
```
corepack enable
pnpm install
```
4
Run it
```
pnpm dev
```
5
Run the tests
```
pnpm test
```

From the README: Using the component

<BloubBot v-model:block="block" v-model:state="state" v-model:playing="playing" />
<BloubBot state="orbit" :size="120" :frozen-at="1.2" />

block is the playback cursor: a montage can play the same state twice, so the index is what identifies where you are; state follows it as an output. Pass frozenAt and the component renders one exact frame with no animation loop, which is how the thumbnails and the state board are drawn.

Props: size, shape, color, expression, paper, frozenAt, cycle, follow, gaze. Models: block, state, playing, elapsed. See BloubBot.vue for the details.

Did you get it running?

On macOS: 1 got it running, 0 got stuck.

Still stuck? Get a written guide

GitManual AI Agent reads the 3 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.