muse4ai README

项目的 README,来自 github.com/andrew-babo/muse4ai。合并为一个 markdown 文件:README.md。

Muse4AI — AI agent bridge, works with Muse

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 · Download · Guide · For agents · Tiếng Việt

Website muse4ai.andrewbabo.com MIT licensed Windows Node.js 22+ 848 tests v2.0.0-beta.35


How it fits together

   ChatGPT · Claude · Cursor · Codex · n8n · your own script
                       │
                       │  REST  ·  MCP  ·  OAuth
                       ▼
              ┌─────────────────────┐
              │   Muse4AI on your PC│   local library, queue,
              │   (Windows app)     │   keys, tokens, history
              └─────────────────────┘
                       │
                       │  your own signed-in Muse session
                       ▼
                     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

🎬 Generate video & images

One call, text-only or with reference photos. Repeat a prompt, pick the account, watch it appear in the in-app queue.

💬 Chat that remembers

Ask questions or iterate on an idea. The conversation id comes back, so the agent can keep the thread going and attach files.

⏱ Extend a finished video

Keep a clip rolling, up to 6 steps and about 60 seconds per chain, in the same conversation it was born in.

🛠 Edit a video by describing it

Attach an MP4 and say what to change in words — no timeline, no rendering settings.

🔑 Two ways to connect

An API key you paste once, or real OAuth: the agent asks, and you approve with the 6-digit code the app shows on screen.

📚 Built-in guide

Every screen has a bilingual guide (English / Vietnamese) with real screenshots, plus a Skill your agent can read.

See it in action

Studio with a prompt ready to run Queue with image and video jobs running
Studio — write the prompt, attach references, run. Queue — live status, thumbnails, quick preview.
Library grid of generated images and videos Settings screen showing how to connect an agent
Library — everything you made, searchable. API & agent — connect an agent in one paste.

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. After that the app checks for new versions by itself and installs them from Settings › About — no need to come back here.

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.

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:

{
  "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:

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"}'

Keys are scoped, rate-limited and individually revocable.

What the agent gets

REST MCP tool
POST /v1/jobs — image / video muse_generate
POST /v1/jobs with kind:"chat" muse_chat
GET /v1/jobs · GET /v1/jobs/{id} muse_list_jobs · muse_get_job
POST /v1/jobs/{id}/cancel muse_cancel_job
POST /v1/assets/{id}/extend · POST /v1/conversations/{id}/extend muse_extend_video · muse_get_extend
GET /v1/status · GET /v1/health muse_status

Full machine-readable contract: GET /v1/openapi.json. For agents that prefer Markdown: llms.txt.

Project layout

Path What lives there
desktop/ The app itself — main process, renderer, REST/MCP/OAuth API, tests, installer
content/ Guide, agent and use-case text shared by the app and the website
agent-kit/ The Muse4AI Skill, so an agent can learn the tool on its own

Development

cd desktop
npm test            # 848 tests
npm run typecheck   # strict TypeScript
npm run package:win # Windows ZIP + installer inputs

Quality checks

Every push, and every Monday at 02:00 UTC, GitHub Actions re-runs the whole suite: 848 tests, a type check, a dependency vulnerability scan, a secret scan across the full git history, and live checks against the public endpoints. If a weekly run fails, an issue is opened automatically.

Honest notes

License

MIT © 2026 Andrew Babo. Third-party notices: desktop/LICENSES/.

Questions or ideas: the website · guide · changelog.

muse4ai (andrew-babo/muse4ai)

正在搜索数据库…

1.2K ·GitHub
这是什么?它让你的 AI 智能体通过你自己的 Muse 账号生成图片和视频。它以本地 Windows 应用的形式运行,并提供 REST、MCP 和 OAuth 接口供智能体调用。
它是独立应用,还是需要导入代码的库?它是独立的 Windows 桌面应用。它在你自己的电脑上运行,并在打开期间提供 API 服务,因此智能体通过网络连接它,而不需要你把它导入项目中。
怎么让它跑起来?从下载页面下载安装程序,运行它,然后在 Accounts 中添加你的 Muse 账号。Windows 会提示该文件未签名,此时请点击“更多信息”,再点击“仍然运行”。
开始前还需要别的东西吗?你需要一个 Muse 账号。如果你不使用安装程序,而是从源码运行,还需要 Node.js 22 或更高版本。
有哪些需要了解的风险吗?它会自动操作你的 Muse 网页会话,因此网站一旦改版就可能失效,而且可能不符合 Meta 的服务条款。本项目为非官方项目,与 Meta 没有关联,所以在依赖它之前请先阅读相关条款。
能在 macOS 或 Linux 上用吗?暂时不行。目前优先支持 Windows,macOS 和 Linux 版本尚未打包或测试。核心代码不依赖 Windows,因此移植已列入路线图。
我的结果和密钥会保存在哪里?不会经过作者运营的服务器中转。结果、密钥和令牌都保存在你的电脑上,位于 %APPDATA%\MuseStudio。
智能体能保持连续对话吗?可以。聊天请求会返回一个会话 ID,因此智能体可以继续同一会话,并向其中附加文件。
我必须粘贴 API 密钥吗?不必。你可以粘贴一次密钥,密钥有作用范围,且可以单独撤销。也可以通过 OAuth 连接,在应用中显示的 6 位验证码进行授权。
大小
19.8 MB
星标
1.2K
更新
提交Nov 10
时长
15天
提交 · 90 天