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

代理有三个工具：

AI代理的示例提示：

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

哪个接口？

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

经验法则：

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

模型

CLI参考

命令

旗帜

配置

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

defaultModel: nano-banana-2
defaultAspectRatio: "1:1"
defaultStyle: none
autoPreview: true
autoSave: true

链接

• Pixelmuse --平台首页
• 注册 --创建一个帐户（包括免费积分）
• API密钥 -管理API密钥
• API文件 -API完整参考（标量）
• 获得学分 --购买信用包

许可证

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

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

版权所有2025 StarMorph LLC。