Skip to content
Back to search

pixelforge

Professional image editing toolkit built for AI agents. CLI, Python API and MCP server. No GUI, no vendor lock-in.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday

Check it deeper on your machine

It has changed since its scan on 20 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Alfredo-ctrl/pixelforge with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Alfredo-ctrl/pixelforge'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/alfredo-ctrl--pixelforge/badge.svg)](/listings/alfredo-ctrl--pixelforge)

HTML

<a href="/listings/alfredo-ctrl--pixelforge"><img src="/api/listings/alfredo-ctrl--pixelforge/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

pip install pixelforge

Needs Python 3.10+. Background removal is optional:

pip install pixelforge[bg]

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 80 lines
  1. # pixelforge
  2. Image editing for AI agents. No GUI, no account, no vendor lock-in: a CLI, a Python API and an MCP server that any agent can drive — Muse, Antigravity, Codex, Claude Code, or a local model.
  3. ## Install
  4. ```sh
  5. pip install pixelforge
  6. ```
  7. Needs Python 3.10+. Background removal is optional:
  8. ```sh
  9. pip install pixelforge[bg]
  10. ```
  11. ## Use it from the terminal
  12. ```sh
  13. # what can it do?
  14. pixelforge ops
  15. # describe a file
  16. pixelforge describe photo.jpg
  17. # edit it: warmer, a bit brighter, gentle vignette
  18. pixelforge edit -i photo.jpg -o photo-edit.jpg --ops '[
  19. {"op": "temperature", "value": 18},
  20. {"op": "exposure", "ev": 0.3},
  21. {"op": "vignette", "strength": 25}
  22. ]'
  23. ```
  24. Output is JSON, so it is easy to parse:
  25. ```json
  26. {"output": "photo-edit.jpg", "format": "JPEG", "size": [4000, 3000], "ops_applied": ["temperature", "exposure", "vignette"]}
  27. ```
  28. ## How an agent uses it
  29. You translate the user's words into ops. `pixelforge ops` lists every operation with its parameters and valid ranges, so there is nothing to guess. Examples:
  30. - "make it warmer and brighter" -> temperature +15, exposure +0.3
  31. - "punchy, high contrast black and white" -> grayscale, contrast 1.3, clarity 40
  32. - "soften the whole frame" -> blur 3
  33. If the user asks for something that is not an op yet, add it — see CONTRIBUTING.md. That is the whole point: the tool grows with what people ask for.
  34. ## Use it from Python
  35. ```python
  36. from pixelforge import load_image, save_image, apply_ops
  37. img = load_image("photo.jpg")
  38. out, applied = apply_ops(img, [{"op": "saturation", "factor": 1.2}])
  39. save_image(out, "photo-edit.jpg")
  40. ```
  41. ## MCP server
  42. Any MCP client can use pixelforge as tools:
  43. ```sh
  44. pixelforge mcp
  45. ```
  46. It speaks MCP over stdio and exposes `edit_image`, `describe_image` and `list_operations`. Example client config:
  47. ```json
  48. {
  49. "mcpServers": {
  50. "pixelforge": {"command": "pixelforge", "args": ["mcp"]}
  51. }
  52. }
  53. ```
  54. ## License
  55. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.