andrew-babo/muse4ai

选用指南

AI 根据 README 整理 · 2026/11/4 14:52:25

适用场景

适合需要让 AI 代理自动生成或编辑图片、视频，并希望本地运行、无需云端中转的场景。

查看 README 依据

<div align="center"> <img src="docs/hero.png" alt="Muse4AI — AI agent bridge, works with Muse" width="100%" /> # Muse4AI **Let your AI agent make the pictures and the videos.** Muse4AI runs on your own Windows PC and hands your Muse session to ChatGPT, Claude, Cursor, Codex, n8n or anything else that speaks **REST**, **MCP** or **OAuth** — with no cloud middleman and no per-seat fee. [**Website**](https://muse4ai.andrewbabo.com) · [**Download**](https://muse4ai.andrewbabo.com/download) · [**Guide**](https://muse4ai.andrewbabo.com/docs) ·

▼ Muse ``` Nothing is relayed through a server we run. The app talks to Muse from your machine, with your session, and keeps every result, key and token in `%APPDATA%\MuseStudio` on that same machine. ## What you can ask an agent to do <table> <tr> <td width="50%"> <h3>🎬 Generate video &amp; images</h3> One call, text-only or with reference photos. Repeat a prompt, pick the account, watch it appear in the in-app queue. </td> <td width="50%"> <h3>💬 Chat that remembers</h3>

使用方式

通过 Windows 应用提供 REST API 和 MCP 端点，代理可通过 API 密钥或 OAuth 连接。

查看 README 依据

The app opens on your desktop and serves its API on `http://127.0.0.1:47821`. ## Connect an agent Open **Settings → API & agent** in the app. It shows a ready-made snippet with your key already filled in — paste it into your agent's config. ### OAuth (no key to copy) The app is a real OAuth authorization server: it publishes `/.well-known/oauth-authorization-server`, registers clients dynamically and signs its own tokens. Point the agent at the MCP endpoint and let it redirect: ```json { "mcpServers": { "muse4ai": { "url": "http://127.0.0.1:47821/mcp" } } } ```

The app then shows a **6-digit code**. Type it into the consent page and the token is issued. Anyone who only knows the link cannot grant themselves access. Revoke any app later under **Settings → API & agent → Connected apps**. ### API key Create a key in the same screen (`msk_…`), then send it as a bearer token: ```bash curl -X POST http://127.0.0.1:47821/v1/jobs \ -H "Authorization: Bearer msk_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"kind":"video","prompt":"a coffee cup on an oak desk, warm morning light"}' ```

部署要求

需要 Windows 10/11，Node.js 22+（从源码运行时），并需安装 Muse 桌面应用。

查看 README 依据

[**For agents**](https://muse4ai.andrewbabo.com/agents) · [Tiếng Việt](docs/README-vi.md)     

<td align="center"><b>Library</b> — everything you made, searchable.</td> <td align="center"><b>API &amp; agent</b> — connect an agent in one paste.</td> </tr> </table> ## Quick start ### 1. Install (easiest) Grab the installer from the [download page](https://muse4ai.andrewbabo.com/download), 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+**. ```bash cd desktop npm install npm run build npm start ```

已知限制

非官方项目，自动化可能因网站变更而失效；目前仅支持 Windows，macOS 和 Linux 尚未打包。

查看 README 依据

- **Unofficial.** Muse4AI is an independent project. It is **not affiliated with, endorsed or sponsored by Meta Platforms, Inc.** "Meta" and "Muse" are trademarks of their owners. - **You own the risk.** The app automates *your* Muse session. Automating a web app can break when the site changes, and may not fit Meta's terms of service — read them before you rely on it. - **Windows first.** macOS and Linux builds are not packaged or tested yet; the core code does not depend on Windows, so porting is on the roadmap.