AI导哈

终端AI图像生成工具

Pixelmuse是一款通过命令行界面（CLI）、交互式终端用户界面（TUI）和MCP服务器提供AI图像生成服务的工具，支持多种模型切换和开发者工作流集成。

  • by starmorph
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 starmorph/pixelmuse-cli

使用说明

AI image generation from the terminal.
CLI, interactive TUI, and MCP server — powered by the Pixelmuse API.

为什么选择Pixelmuse？

  • 一个命令，任何型号。 Flux、Imagen 3、Recraft V4等-切换带有标志的模型，没有单独的帐户或API键。
  • 专为开发人员工作流而构建。 来自stdin的管道，用于脚本编写的JSON输出，用于提示迭代的监视模式，用于AI代理的MCP服务器。
  • 可预测的信贷定价。 每代1-7学分，大多数型号只有1学分。注册时免费获得积分。

开始使用

npm install -g pixelmuse
pixelmuse setup

设置向导创建您的帐户（打开浏览器），配置API密钥，并可选择为Claude Code、Cursor或Windsurf设置MCP服务器。新帐户包括 15个免费学分.

需要Node.js 20+。对于终端图像预览，请安装 查法 (brew install chafa / sudo apt install chafa).

快速开始

# Generate an image
pixelmuse "a cat floating through space"

# Choose model and aspect ratio
pixelmuse "neon cityscape at night" -m recraft-v4 -a 16:9

# Apply a style
pixelmuse "mountain landscape" -s anime -a 21:9

# Save to specific path
pixelmuse "app icon, minimal" -o icon.png

提示模板

将可重用的提示保存为带变量和默认设置的YAML文件。

# Scaffold a new template
pixelmuse template init product-shot

# Generate with a template
pixelmuse template use blog-thumbnail --var subject="React hooks guide"

# List all templates
pixelmuse template list

模板存储在 ~/.config/pixelmuse-cli/prompts/:

# blog-thumbnail.yaml
name: Blog Thumbnail
description: Dark-themed blog post thumbnail
prompt: >
  A cinematic {{subject}} on a dark gradient background,
  dramatic lighting, 8K resolution
defaults:
  model: nano-banana-2
  aspect_ratio: "16:9"
variables:
  subject: "code editor with syntax highlighting"
tags: [blog, thumbnail, dark]

交互式TUI

用于可视化浏览、生成向导、图库和帐户管理的完整终端UI：

pixelmuse ui

脚本和管道

# Pipe prompt from stdin
echo "hero banner for SaaS landing page" | pixelmuse -o hero.png
cat prompt.txt | pixelmuse -m recraft-v4

# JSON output for scripting
pixelmuse --json "logo concept" | jq .output_path

# Watch mode — regenerates when prompt file changes
pixelmuse --watch prompt.txt -o output.png

# Skip preview, copy to clipboard
pixelmuse "avatar" --no-preview --clipboard

MCP服务器（克劳德代码、游标、Windsurf）

MCP服务器允许AI代理生成图像、列出模型并检查余额，无需手动执行CLI步骤。

克劳德代码 --添加到 ~/.claude/.mcp.json:

{
  "mcpServers": {
    "pixelmuse": {
      "command": "npx",
      "args": ["-y", "pixelmuse-mcp"],
      "env": {
        "PIXELMUSE_API_KEY": "pm_live_your_key_here"
      }
    }
  }
}

光标/风帆 --添加到MCP设置中：

{
  "pixelmuse": {
    "command": "npx",
    "args": ["-y", "pixelmuse-mcp"],
    "env": {
      "PIXELMUSE_API_KEY": "pm_live_your_key_here"
    }
  }
}

代理有三个工具：

工具 它做什么
generate_image 根据带有模型、纵横比、样式和输出路径的提示生成图像。
list_models 列出所有具有信用成本的可用型号。
check_balance 检查您的信用余额和计划信息。

AI代理的示例提示：

  • “为我的登录页面生成英雄图像，16:9，保存到 ./public/hero.png"
  • “使用动漫风格创建一个关于React钩子的博客缩略图”
  • “Pixelmuse有哪些型号？”

哪个接口？

Pixelmuse提供四个接口。选择一个适合您的工作流程-他们都使用相同的API和凭据。

命令行界面 文本用户界面 MCP 服务器 克劳德技能
这是什么 命令行工具 交互式终端UI AI代理工具服务器 克劳德代码提示模板
发射 pixelmuse "prompt" pixelmuse ui 自动从Claude/Cursor开始 关键字自动触发
最佳 脚本、自动化、CI/CD 可视化浏览、探索模型 让AI代理生成图像 在对话中生成图像
输入 标志、标准输入、管道、监视模式 带菜单的引导向导 人工智能从自然语言中决定参数 自然语言到克劳德

经验法则：

  • 您键入提示 → CLI或TUI
  • AI键入提示 → MCP服务器或克劳德技能
  • 快速一次性 → CLI
  • 浏览/探索 → TUI

模型

型号 积分 最适合
纳米香蕉2 （默认） 1 速度、文本渲染、世界知识
Nano Banana Pro 4 文本渲染、实时信息、多图像编辑
Flux Schnell 1 快速模型、构思
Google Imagen 3 1 逼真的照片，复杂的构图
重新起草V4 1 排版、设计、构图
重新绘制V4 Pro 7 高分辨率设计，艺术指导

CLI参考

命令

命令 描述
pixelmuse setup 首次设置向导（帐户、MCP、默认值）
pixelmuse "prompt" 生成图像（默认命令）
pixelmuse models 列出可用型号及其成本
pixelmuse account 账户余额和使用情况统计
pixelmuse history 最近几代表
pixelmuse open <id> 在系统查看器中打开一代
pixelmuse login 使用API密钥进行身份验证
pixelmuse logout 删除存储的凭据
pixelmuse template <cmd> 管理提示模板
pixelmuse ui 启动交互式TUI

旗帜

标志 描述
-m, --model 型号ID（默认值： nano-banana-2)
-a, --aspect-ratio 纵横比（默认值： 1:1)
-s, --style realistic, anime, artistic, none
-o, --output 输出文件路径
--json 机器可读JSON输出
--no-preview 跳过终端图像预览
--open 在系统查看器中打开结果
--clipboard 将图像复制到剪贴板
--watch <file> 查看提示文件，保存后重新生成
--no-save 不将图像保存到磁盘

配置

设置在 ~/.config/pixelmuse-cli/config.yaml:

defaultModel: nano-banana-2
defaultAspectRatio: "1:1"
defaultStyle: none
autoPreview: true
autoSave: true
路径 内容
~/.config/pixelmuse-cli/config.yaml 用户设置
~/.config/pixelmuse-cli/auth.json API密钥（如果密钥链不可用，则回退）
~/.config/pixelmuse-cli/prompts/ 提示模板YAML文件
~/.local/share/pixelmuse-cli/generations/ 自动保存的生成图像

链接

许可证

商业来源许可证1.1（BSL 1.1）。看 许可证 了解详情。

除了提供竞争性的图像生成API或平台之外，任何用途都是免费的。2029年3月1日转换为GPL-2.0。

版权所有2025 StarMorph LLC。

相关 MCP