Content
z-card-image avatar

z-card-image

Automated text-to-image rendering engine for social media posts, article covers, and long-form threads. Supports X-style, WeChat, and poster templates with high-precision text formatting and highlights.

Introduction

z-card-image is a specialized software agent skill designed to bridge the gap between raw text content and professional visual assets. It allows users to convert social media posts, long-form articles, and general text into high-quality PNG images. The engine excels in handling specific aesthetic standards, including X (formerly Twitter) style long-form thread screenshots, WeChat Official Account covers, and aesthetic text posters. It is built for content creators, social media managers, and automated publishing workflows that require rapid, consistent branding.

  • Automated template matching: Intelligent routing based on input content, selecting appropriate layouts for posters, article pagination, or X-like thread visualizations.

  • Advanced text processing: Supports dynamic text highlighting (--hl1, --hl2, --hl3, --highlight-words) and automatic text shortening or pagination for content exceeding visual bounds.

  • Platform-specific presets: Pre-configured visual settings for platforms like Xiaohongshu (Little Red Book) and WeChat, ensuring brand-consistent background colors and footers.

  • Technical integration: Operates via Python-based rendering scripts, leveraging Google Chrome for high-fidelity HTML-to-PNG conversion, with full support for user-defined output paths.

  • Input requirements: Expects structured 'post data' or plain text; automatically validates text length and aspect ratios against template limits.

  • Workflow guidelines: When handling long threads, the agent automatically splits content into multi-part visuals (Part 1, Part 2, etc.) to maintain readability.

  • Environment prerequisites: Requires Python 3 and a local Chromium-based browser installation to perform headless rendering.

  • Constraint handling: If a requested aspect ratio is unavailable, the system suggests valid alternatives rather than failing silently; ensures titles are compressed if they exceed visual limits for cover images.

Repository Stats

Stars
4,437
Forks
1,203
Open Issues
7
Language
Python
Default Branch
main
Sync Status
Idle
Last Synced
Apr 29, 2026, 01:17 PM
View on GitHub