feat: add post-processing script for analog print effects #34

Merged
magnus merged 1 commit from feat/postprocess-script into main 2026-05-26 14:09:18 -04:00
Contributor

Summary

Adds a post-processing script for analog print effects, transforming clean AI-generated images into physically printed artifacts. This is the single highest-leverage quality improvement — it works regardless of which image generation provider is used.

Changes

  • nous-branding/scripts/postprocess.py — New Python script (Pillow + numpy) with 14 analog-print effects organized into three processing modes (imprint, nous, standard).
  • nous-branding/SKILL.md — New "Post-Processing" section documenting modes, intensity calibration, and integration workflow.

Closes #33

Type of Change

  • New feature
  • 🐛 Bug fix
  • ♻️ Refactor
  • 📝 Documentation (also includes doc updates)
  • 🧪 Test
  • 🔧 CI/CD

Checklist

  • Script passes Python syntax check (ast.parse)
  • SKILL.md updated with usage documentation
  • MIT attribution to plntrprotocol/nous-branding in script header
  • Three processing modes documented with intensity calibration

Notes for Reviewers

Adapted from the approach in plntrprotocol/nous-branding's MIT-licensed postprocess.py. Our implementation is independent code sharing the same algorithmic goals — attribution is in the script header. The 14 effects mirror their --mode imprint pipeline, which is the community-corrected target for the Nous aesthetic.


Filed by Jasper (AI agent on behalf of Magnus Hedemark)

## Summary Adds a post-processing script for analog print effects, transforming clean AI-generated images into physically printed artifacts. This is the single highest-leverage quality improvement — it works regardless of which image generation provider is used. ## Changes - **`nous-branding/scripts/postprocess.py`** — New Python script (Pillow + numpy) with 14 analog-print effects organized into three processing modes (`imprint`, `nous`, `standard`). - **`nous-branding/SKILL.md`** — New "Post-Processing" section documenting modes, intensity calibration, and integration workflow. ## Related Issue Closes #33 ## Type of Change - [x] ✨ New feature - [ ] 🐛 Bug fix - [ ] ♻️ Refactor - [ ] 📝 Documentation (also includes doc updates) - [ ] 🧪 Test - [ ] 🔧 CI/CD ## Checklist - [x] Script passes Python syntax check (`ast.parse`) - [x] SKILL.md updated with usage documentation - [x] MIT attribution to plntrprotocol/nous-branding in script header - [x] Three processing modes documented with intensity calibration ## Notes for Reviewers Adapted from the approach in plntrprotocol/nous-branding's MIT-licensed postprocess.py. Our implementation is independent code sharing the same algorithmic goals — attribution is in the script header. The 14 effects mirror their `--mode imprint` pipeline, which is the community-corrected target for the Nous aesthetic. --- Filed by Jasper (AI agent on behalf of Magnus Hedemark)
Adds scripts/postprocess.py with 14 analog-print degradation effects
(warm grade, CRT scanlines, film grain, Bayer dither, vignette,
chromatic aberration, screen print texture, paper fiber, ink bleed,
palette compression, xerox threshold, registration offset, plate
wobble, print scuffs) and corresponding SKILL.md documentation.

Adapted from the approach pioneered by plntrprotocol/nous-branding
(MIT) — same goals, independent implementation.

Supports three modes: imprint (full 14 effects), nous (9 base effects),
standard (6 light effects). Intensity calibration from 0.45 to 0.8+.

Closes #33

Signed-off-by: Magnus Hedemark <magnus919@pm.me>
magnus force-pushed feat/postprocess-script from cd5b72a302 to 612086170d 2026-05-26 14:09:08 -04:00 Compare
magnus merged commit 2a84712336 into main 2026-05-26 14:09:18 -04:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
magnus/agent-skills!34
No description provided.