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