crochet-engine

crochetpatterngen-engine

crochetpatterngen.com 背后的确定性照片转钩针图表引擎——打包为 Python 库、CLI 和 MCP 服务，让 AI Agent（Claude Desktop、Cursor 等）能将照片转换为针数精确的钩针图表。

确定性，而非生成式。 这里没有 AI 图像生成，只有调整尺寸、中位数切分颜色量化和清理杂色。相同的输入，每次都会生成相同的图表和相同的针数。不会凭空生成行数。

为什么选择这个引擎

• 真实针数——每张图表都会附带各颜色的十六进制值和针数，且总和与网格大小完全一致。图表所示即实际编织效果。
• C2C 方块纵横比校正——C2C 方块的实际宽度大于高度（0.7:1 高:宽）。引擎会调整网格尺寸，让编织成品保持照片的比例，而不是变得扁长。
• 5 种技法预设——graph、c2c、tapestry、mosaic、filet。
• 纱线用量估算——支持 6 种纱线粗细（fingering → super bulky），并按颜色估算用量。
• 无需笨重依赖——仅需 Pillow + numpy。可选安装 rembg 附加组件以移除背景。

安装

pip install crochetpatterngen-engine          # core
pip install crochetpatterngen-engine[mcp]     # + MCP server
pip install crochetpatterngen-engine[rembg]   # + background removal

Python API

from PIL import Image
from crochet_chart_engine import generate_chart, render_design, estimate_yarn

png_bytes, meta = generate_chart(
    Image.open("photo.jpg"),
    technique="c2c",     # graph | c2c | tapestry | mosaic | filet
    grid_w=60,           # 20..120
    n_colors=8,          # 2..16
)
# meta: {"grid_w", "grid_h", "colors": [{"hex", "count"}],
#        "total_stitches", "technique", "warning"}

yarn = estimate_yarn(meta, weight="worsted")
# {"total_yards": ..., "colors": [{"hex", "count", "yards"}], ...}

png_bytes, meta = render_design("designs/frog.txt")  # ASCII design -> chart

CLI

crochet-chart chart photo.jpg out.png --technique c2c --grid-w 60 --colors 8
crochet-chart design designs/frog.txt frog.png
crochet-chart yarn photo.jpg --technique graph --weight worsted

MCP 服务（Claude Desktop 及其他）

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "crochet": {
      "command": "uvx",
      "args": ["--from", "crochetpatterngen-engine[mcp]", "crochetpatterngen-mcp"]
    }
  }
}

或者通过常规 pip 安装：

{
  "mcpServers": {
    "crochet": {
      "command": "python",
      "args": ["-m", "crochet_chart_engine.mcp_server"]
    }
  }
}

提供的工具（stdio 传输）：

工具	功能
photo_to_chart	本地图像路径 → 图表 PNG（base64 或保存到 output_path）+ 各颜色针数 JSON
render_ascii_design	ASCII 设计文件 → 图表 PNG + 针数
estimate_yarn_tool	针数 → 单种纱线粗细或 all 对应的各颜色用量

ASCII 设计格式

参见 designs/frog.txt 和 designs/dragon.txt：

# comment
palette: G=#58A05C, W=#FFFFFF, .=#FAFAF7
title: Frog Face
technique: graph
---
..GGGG..........GGGG....
.GGWWGG........GGWWGG...

每针使用一个字符；. 表示背景/填充颜色。每行会补齐至最长行的长度。

开发

pip install -e .[dev,mcp]
pytest tests/

许可证

MIT——详见 LICENSE。

---

可在 crochetpatterngen.com 使用免费网页工具和图案库。