Reading the repo

Opening the box…

Assembly instructions

andrew-babo/muse4ai

Muse4AI — let your AI agent make the pictures and the videos. Local Windows bridge for Muse via REST, MCP, and OAuth.

TypeScript

Difficulty: Easy
Time: about 5 min
Stars: ★ 849
Activity: Updated this month
License: MIT
Open issues: 0
Got it running: Be the first
Looked up: 12 h ago

Saved setup from 12 h ago

Start here

Will it work on my device?

Yes, it runs on macOS

You'll build it yourself with Node.js.

Checking for

Before you start: Quick start

1. Install (easiest)

Grab the installer from the download page, run it, then add your Muse account in Accounts. Windows will warn that the file is unsigned — choose More info → Run anyway.

2. Run from source

Needs Node.js 22+.

cd desktop
npm install
npm run build
npm start

The app opens on your desktop and serves its API on http://127.0.0.1:47821.

3 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/andrew-babo/muse4ai.git
cd muse4ai

2
Install the required tools
Node.js
```
brew install node
```
3
Follow the README: Quick start
In the maintainers' order. Do the README instructions above first — they cover steps outside the terminal.
```
npm install
npm run build
npm start
```

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

Claude reads the 1 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.