Catalog PyPI
Back to packageRELEASE DETAILS

1.0.0

PyPI

ai-img-gen

独立图像生成工具 - 支持智谱AI、OpenAI、自定义API,无需运行时依赖

aiclicogviewdalleimage-generationmcpopenaizhipuai
Published10 Mar 2026
Direct dependencies3
Transitive dependenciesNot calculated

README

Version 1.0.0 documentation

Image Generator

独立图像生成工具,支持多种 AI 图像生成 API。

特点

  • ✅ 独立可执行 - 无需安装 Python 或依赖
  • ✅ 跨平台 - 支持 Windows/Linux/macOS
  • ✅ 多 API - 支持智谱AI、OpenAI、自定义API
  • ✅ MCP 服务器 - 可集成到 Claude Code/OpenClaw
  • ✅ 零依赖 - 仅使用 Python 标准库

安装

方式一:PyPI 安装(推荐)

pip install image-gen-mcp

安装后可直接使用:

# 命令行工具
image-gen -k YOUR_KEY -t "一只可爱的橘猫"

# MCP 服务器配置到 ~/.claude/settings.json
image-gen-mcp

方式二:下载可执行文件

从 Releases 下载对应平台的可执行文件。

方式三:从源码运行

git clone https://github.com/your-username/image-gen.git
cd image_gen
python3 img_gen.py -k YOUR_KEY -t "风景"

快速开始

命令行使用

# 智谱AI(默认)
image-gen -k YOUR_KEY -t "日落风景" -o ~/sunset.png

# OpenAI DALL-E
image-gen -p openai -k YOUR_KEY -m dall-e-3 -t "森林小屋"

# 自定义 API
image-gen -p custom -u https://api.example.com/v1/images -k KEY -t "山水画"

作为 MCP 服务器使用

  1. 编辑 ~/.claude/settings.json:
{
  "mcpServers": {
    "image-gen": {
      "command": "image-gen-mcp",
      "env": {
        "IMAGE_GEN_API_KEY": "your-api-key",
        "IMAGE_GEN_MODEL": "cogview-3-flash"
      }
    }
  }
}
  1. 重启 Claude Code,然后直接对话:
你: 生成一张赛博朋克城市的图片

命令行参数

参数说明必需
--provider, -pAPI 提供商 (zhipu/openai/custom)否
--api-key, -kAPI 密钥是
--model, -m模型名称否
--api-url, -u自定义 API 地址否
--prompt, -t图片描述是
--size, -s图片尺寸否
--output, -o输出路径否

支持的模型

智谱AI (zhipu)

模型说明
cogview-3-flash快速生成(推荐)
cogview-3高质量生成

API 密钥: https://open.bigmodel.cn/usercenter/apikeys

OpenAI (openai)

模型说明
dall-e-2标准质量
dall-e-3高质量

API 密钥: https://platform.openai.com/api-keys

开发

打包可执行文件

# Linux/macOS
chmod +x build.sh && ./build.sh

# Windows
build.bat

发布到 PyPI

chmod +x publish.sh && ./publish.sh

文件结构

image_gen/
├── img_gen.py        # 独立可执行程序源码
├── mcp_server.py     # MCP 服务器
├── build.sh          # Linux/macOS 打包脚本
├── build.bat         # Windows 打包脚本
├── publish.sh        # PyPI 发布脚本
├── pyproject.toml    # 项目配置
├── .github/workflows/ # CI/CD 配置
├── README.md         # 本文档
└── LICENSE           # MIT 许可证

技术实现

  • 仅用标准库 - urllib, json, pathlib, argparse
  • PyInstaller 打包 - 单文件可执行
  • MCP 协议 - 与 LLM 集成

许可证

MIT

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 4

Native requirements
3 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
mcp
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
mcp>=0.9.0; extra == "dev"runtime
pyinstaller
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
pyinstaller; extra == "dev"runtime
pytest
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
pytest; extra == "dev"runtime
mcp
Environment
{
  "extras": "",
  "marker": "extra == \"mcp\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
mcp>=0.9.0; extra == "mcp"runtime

Distribution files

2 collected
ai_img_gen-1.0.0-py3-none-any.whl

bdist_wheel · 14.65 KB · Python py3

Source file
ai_img_gen-1.0.0.tar.gz

sdist · 6.97 KB · Python source

Source file

Repository

PENDING
your-username/img-gen-cli

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 21 Oct, 11:02 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:98ac086351ea0c20ba487e545d4afbfffcea508d6d8d79d89da74a91b4a5c568

Other collected versions

View all collected versions →