RedInk addresses the complexity of creating Xiaohongshu-style posts by automating the generation of both text and accompanying images from a single user prompt. It targets content creators, marketers, and individuals seeking to simplify their social media output. The primary benefit is drastically reduced effort and time for producing visually consistent and stylistically appropriate Xiaohongshu content.

How It Works

The project employs a Python Flask backend and a Vue.js frontend. Core AI capabilities are powered by Google Gemini for text generation and a component referred to as 'Nano Banana Pro' for image generation. The workflow involves taking a user's input sentence or theme, generating a content outline, refining page content, and then producing corresponding images, optionally mimicking the user's existing Xiaohongshu profile style for brand consistency.

Quick Start & Requirements

• Primary Install: Docker (recommended): docker run -d -p 12398:12398 -v ./output:/app/output histonemax/redink:latest. Access via http://localhost:12398.
• Local Development: Requires Python 3.11+, Node.js 18+, pnpm, and uv. Clone the repo, configure API keys in text_providers.yaml and image_providers.yaml, install dependencies (uv sync, pnpm install), and run backend (uv run python -m backend.app) and frontend (pnpm dev) separately.
• Prerequisites: API keys for text (e.g., OpenAI, Gemini) and image generation services (e.g., Google GenAI, OpenAI compatible).
• Docs: Web UI configuration is recommended. Links to GitHub Issues provided for support.

Highlighted Details

• Generates complete Xiaohongshu posts (cover + multiple pages) from a single sentence.
• Supports style consistency by optionally using user's profile screenshot (avatar, signature, etc.).
• Offers a high concurrency mode for faster image generation (up to 15 parallel), configurable via settings.
• Provides both Docker and local development deployment options.

Maintenance & Community

• Actively maintained with recent updates (v1.3.0, v1.2.0) including Docker support and enhanced configuration.
• Community support via GitHub Issues: https://github.com/HisMax/RedInk/issues.
• Author contact: Email (histonemax@gmail.com), WeChat (Histone2024).

Licensing & Compatibility

• License: CC BY-NC-SA 4.0 for personal use. This license permits free personal use, sharing, and modification but strictly prohibits commercial use and requires derivative works to be shared under the same license.
• Commercial Use: Requires explicit commercial licensing contact with the author.

Limitations & Caveats

• The default CC BY-NC-SA 4.0 license prohibits commercial applications, necessitating separate licensing agreements.
• Users are responsible for managing their API quotas for integrated AI services.
• High concurrency image generation is not recommended for platforms like GCP trial accounts due to potential rate limiting.