HisMax /RedInk

Red Ink - A one-stop Xiaohongshu image-and-text generator based on the 🍌Nano Banana Pro🍌, "One Sentence, One Image: Generate Xiaohongshu Text and Images."

★ 5,687⑂ 1,055👁 24▤ 0
PythonCreated 2025-11-25redink.top
+0
Daily
+0
Weekly
+62
Monthly
5,687
stars
1,055
forks
24
watchers
–
prs
–
issues
0
releases

README

中文 | English








 Official Site → Redink.top



Various social media covers generated with RedInk - AI-powered, consistent style, accurate text



---

 ✨ Showcase

 Type One Sentence, Get Complete Image & Text Posts


Step 1: Smart Outline Generation



!Outline Example

Features:
- ✏️ Edit content for each page
- 🔄 Reorder pages (not recommended)
- ✨ Custom description per page (highly recommended)




🎨 Step 2: Cover Page Generation



!Cover Example

Cover Highlights:
- 🎯 Matches your personal style
- 📝 Accurate text rendering
- 🌈 Visually consistent and coordinated




📚 Step 3: Batch Content Page Generation



!Content Page Example

Generation Notes:
- ⚡ Concurrent generation for all pages (up to 15 by default)
- ⚠️ Disable high concurrency in settings if your API doesn't support it
- 🔧 Regenerate individual pages you're not satisfied with



---

 🏗️ Tech Stack





 🔧 Backend

| Technology | Description |
|------|------|
| Language | Python 3.11+ |
| Framework | Flask |
| Package Manager | uv |
| Text AI | Gemini 3 |
| Image AI | 🍌 Nano Banana Pro |




 🎨 Frontend

| Technology | Description |
|------|------|
| Framework | Vue 3 + TypeScript |
| Build Tool | Vite |
| State Management | Pinia |
| Styling | Modern CSS |





---

 📦 Deployment

 Option 1: Docker (Recommended)

The simplest way — one command to start:

bash
docker run -d -p 12398:12398 -v ./history:/app/history -v ./output:/app/output histonemax/redink:latest


Visit http://localhost:12398 and configure your API Key in the Settings page.

Using docker-compose (optional):

Download docker-compose.yml, then:

bash
docker-compose up -d


Docker Notes:
- The container does not include any API Keys — configure them in the web UI
- Use -v ./history:/app/history to persist history
- Use -v ./output:/app/output to persist generated images
- Optional: mount custom config -v ./text_providers.yaml:/app/text_providers.yaml

---

 Option 2: Local Development

Prerequisites:
- Python 3.11+
- Node.js 18+
- pnpm
- uv

 1. Clone the Repository
bash
git clone https://github.com/HisMax/RedInk.git
cd RedInk


 2. Configure API Services

Copy the config templates:
bash
cp text_providers.yaml.example text_providers.yaml
cp image_providers.yaml.example image_providers.yaml


Edit the config files with your API Key and service settings, or configure them later via the Settings page in the web UI.

 3. Install Backend Dependencies
bash
uv sync


 4. Install Frontend Dependencies
bash
cd frontend
pnpm install


 5. Start the Services

 One-Click Start (Recommended)

Run the start script to automatically install dependencies and launch both frontend and backend:

- macOS: start.sh or double-click scripts/start-macos.command
- Linux: ./start.sh
- Windows: Double-click start.bat

The browser will automatically open at http://localhost:5173

 Manual Start

Start Backend:
bash
uv run python -m backend.app

Visit: http://localhost:12398

Start Frontend:
bash
cd frontend
pnpm dev

Visit: http://localho

Snapshot: 2026-11-04T14:00:00Z · Data license Apache-2.0 · JSON