Content
# AIWriteX - Intelligent Content Creation Platform Based on CrewAI
[](https://www.python.org/) [](https://pypi.org/project/crewai) [](https://pypi.org/project/aiforge-engine) [](https://pywebview.flowrl.com/) [](https://fastapi.tiangolo.com/) [](https://grapesjs.com/) [](https://microsoft.github.io/monaco-editor/) [](https://marked.js.org/) [](https://github.com/iniwap/PyWinGUIBuilder) [](https://iniwap.github.io/AIWriteX)
**AIWriteX** is a next-generation intelligent content creation platform based on CrewAI and [AIForge](https://iniwap.github.io/AIForge). Starting from automated tools for WeChat Official Accounts, it is redefining the boundaries of AI-assisted content creation by integrating the four capabilities of "search + reference + AI + creativity," offering various extraordinary features that make content creation full of infinite possibilities.
> **Want to see the effect first?** 👉 [Article Preview](#-WeChat-Official-Account-Template-Preview)
> **Feeling inspired to take action?** 👉 [Get Started Now](#-Quick-Start)
> **Like this project?** ⭐ Give it a Star to show your support!
<img src="image/preview/preview.jpg" width="100%">
## 💎 Basic Features
- **Automatic Retrieval of Trending Topics**: Real-time scraping of trending topics from major platforms to ensure article titles and content are in line with current trends.
- **Automatic Generation and Formatting**: Utilizing CrewAI's multi-role collaboration to automatically generate articles and complete stylish formatting.
- **💡 Real-time Article Generation**: Employing AIForge's multi-search strategy to reject outdated content and ensure the timeliness of articles.
- **💡 Specified Topics and Reference Articles**: Supports custom article topics and provides reference articles, combining AI to generate high-quality content.
- **Automatic Publishing of Text and Images**: One-click publishing of text and image messages to WeChat Official Accounts, simplifying the operational process.
- **UI Visual Management**: Provides a software interface that is simple and efficient to operate.
- **💡 Configuration Management**: Configuration item editing is clearer and easier to use.
- **💡 Template Management**: Supports various operations on templates, including adding, deleting, querying, and modifying.
- **💡 Article Publishing Management**: Supports various operations for article management, batch processing, publishing records, and selection of official accounts.
- **💡 Image Management**: Supports custom settings for article covers, images, and other related operations.
- **Supports Two Operating Modes**:
- **Development Mode**: Suitable for technical users, supports flexible custom development to accommodate complex requirements.
- **Software Mode**: No development environment required; simply install the software and fill in the configuration, suitable for non-technical users to quickly experience the product.
## Core Features:
- 🤖 Multi-Agent Collaboration: Team collaboration of researchers, writers, reviewers, and designers based on the CrewAI framework
- 🔍 Real-Time Information Fusion: Integration of the AIForge engine to automatically gather trending topics and the latest news from the internet
- 🎨 Creative Content Transformation: Supports various creative modes such as style conversion, time-space travel, and role-playing
- 📱 Cross-Platform Publishing: Supports mainstream platforms such as WeChat Official Accounts, Xiaohongshu, Douyin, and Zhihu (under development)
- ⚡ High Timeliness: Combines "search + reference + AI" to generate high-quality content with strong real-time relevance
- 🎯 Intelligent Typesetting: Automatically generates cool layouts that adapt to the display characteristics of various platforms
## 🎨 Dimensional Creative Transformation System
AIWriteX's unique **Multidimensional Creative Transformation Engine** breaks through the boundaries of traditional AI content creation, achieving a true "infinite combination of creativity"!
### ✨ Core Features
#### 🎯 Intelligent Dimension Selection
- **Automatic Selection Mode**: AI intelligently analyzes content characteristics and automatically selects the most suitable dimension combinations
- **Manual Precision Control**: 15 dimension categories, each with 10+ preset options, supporting custom input
- **Compatibility Verification**: Smartly avoids conflicting dimension combinations to ensure cohesive and unified creative effects
#### 🌟 15 Major Creative Dimensions
**Stylistic Expression Dimension**
- **Stylistic Styles**: 10 styles including poetry, prose, novels, academic papers, news reports, etc.
- **Language Style**: Classical elegance, modern vernacular, internet slang, poetic language, etc.
- **Tone and Mood**: Serious and solemn, relaxed and casual, humorous and witty, mysterious and enigmatic, etc.
**Cultural and Temporal Dimension**
- **Cultural Perspectives**: Eastern philosophy, Western speculation, Japanese mono no aware, French romance, Latin American flair, etc.
- **Temporal and Spatial Backgrounds**: Spring and Autumn period, Tang and Song dynasties, Republic of China turmoil, Cyberpunk 2077, etc.
- **Scene and Environment**: Urban prosperity, pastoral idyll, sci-fi future, classical courtyard, etc.
**Character Technique Dimension**
- **Character Personalities**: Classic figures such as Li Bai, Lu Xun, Confucius, scientists, artists, etc.
- **Performance Techniques**: First-person perspective, stream of consciousness, montage, symbolism, etc.
- **Narrative Perspectives**: Omniscient perspective, multiple perspective switching, observer perspective, etc.
**Structure and Rhythm Dimension**
- **Article Structure**: Chronological order, spatial order, causal relationships, contrast and comparison, etc.
- **Rhythm and Cadence**: Fast-paced, slow-paced, varied, layered progression, etc.
**Audience and Theme Dimension**
- **Target Audience**: Young groups, professionals, travel enthusiasts, technology lovers, etc.
- **Theme Content**: Reflections on technology, environmental concepts, love stories, adventure journeys, etc.
- **Emotional Tone**: Healing, suspenseful and thrilling, passionate and motivational, deep philosophical thoughts, etc.
### 🚀 Creative Combination Examples
**Classic Combination Case:**
```yaml
# Example 1: A Technological Review Across Time and Space
Dimension Combination:
- Character Role: Li Bai (Romantic Poet)
- Temporal and Spatial Background: The Prosperous Era of Tang and Song Dynasties (Cultural Prosperity, Flourishing Poetry)
- Stylistic Style: Poetry (Melodious Rhythm, Profound Imagery)
- Thematic Content: Reflection on Technology (Technological Advancement, Humanistic Care)
Effect: Commenting on modern AI technology with the poetic touch of Li Bai, from the perspective of the Tang Dynasty
# Example 2: Magical Realism Travel Guide
Dimension Combination:
- Cultural Perspective: Latin American Flair (passionate and magical realism)
- Expression Format: Letter Format (sincere and time-traveling)
- Target Audience: Travel Enthusiasts (exploring the world, experiencing richness)
- Language Style: Poetic Language (rhythmically beautiful, profound imagery)
Effect: A city guide written in letter format for travelers in the style of magical realism
```
**Creative Process:**
```mermaid
graph LR
A[Original Topic] --> B[Basic Content Generation]
B --> C[Dimensional Creative Engine]
C --> D[Intelligent Dimension Selection]
D --> E[AI Creative Transformation]
E --> F[Final Creative Work]
C --> G[15 Dimension Categories]
G --> H[150+ Preset Options]
H --> I[Unlimited Customization]
```
### 🎯 Use Cases
- **Content Creators** - The same material, various styles, enriching content forms
- **Educators** - Explaining complex concepts from different perspectives to enhance understanding
- **Marketers** - Adjusting content style and expression for different target audiences
- **Literature Enthusiasts** - Experiencing the joy of creation across eras and cultures
### ⚙️ Configuration Example
```yaml
dimensional_creative:
enabled: true # Enable creative transformation
auto_dimension_selection: true # Automatically select dimensions
max_dimensions: 5 # Maximum number of dimensions
creative_intensity: 1.0 # Creative intensity (0.7-1.5)
preserve_core_info: true # Preserve core information
compatibility_threshold: 0.6 # Compatibility threshold
```
> **Imagine**: What a wonderful experience it would be if Li Bai introduced the ancient city of Chang'an to modern travelers in the form of letters using magical realism! This is the charm of the AIWriteX dimensional creative system!
---
### More Features (Configuration)
Through the `config.yaml` and `aiforge.toml` configuration files, highly personalized features can be achieved (it is recommended to edit configurations using the interface/software mode). Below are the key configuration items:
- **`config.yaml` Configuration Items**
| Configuration Item | Description |
|----------------------------|------------------------------------------------------------------------------|
| **platforms** | Set the random selection weight for trending topics on each platform, controlling the selection priority |
| **wechat** | Supports configuring multiple WeChat official accounts (when auto-publishing, **required** `appid`, `appsecret`, `author`) |
| **wechat.credentials** | `call_sendall`, `sendall`, `tag_id` are used to control mass sending (only applicable to verified accounts) |
| **api** | Supports multiple large model platforms, **required** `api_key` |
| **api.api_type** | Supports multiple large model platforms; modify `api_type` to switch platforms, such as OpenRouter |
| **api.OpenRouter.model_index** | Modify `model_index` to select a specific model within the platform |
| **api.OpenRouter.model** | Supports various models (e.g., openrouter/deepseek/deepseek-chat-v3-0324:free) |
| **api.OpenRouter.key_index** | Modify `key_index` to switch accounts (fully utilize free quotas; paid accounts do not require multiple) |
| **api.OpenRouter.api_key** | Supports multiple OpenRouter `api_key` |
| **img_api** | Image generation model for WeChat official account cover images |
| **img_api.api_type** | `ali` (requires `api_key`) or `picsum` (random images) |
| **img_api.picsum** | Random image generation method to reduce image generation consumption |
| **use_template** | Whether to use built-in templates; if not used, AI generates article HTML directly based on requirements |
| **template** | Specify template file name (e.g., `template1`); if empty or nonexistent, a random selection is made |
| **template_category** | Template category, precisely matching topic types (e.g., health and wellness); specified templates must exist under the category |
| **use_compress** | Whether to compress template uploads to reduce token consumption |
| **aiforge_search_max_results**| Maximum number of search results returned by AIForge, controlling search breadth |
| **aiforge_search_min_results**| Minimum number of search results returned by AIForge; larger values yield richer content but higher failure rates |
| **min_article_len** | Minimum word count for generated articles (default 1000) |
| **max_article_len** | Maximum word count for generated articles (default 2000) |
| **auto_publish** | Control automatic publishing; check (true) for auto-publishing, uncheck (false) for manual publishing |
| **article_format** | Format of the generated article (HTML, Markdown, txt); if not HTML, only the article is generated without a template |
| **format_publish** | When the article format is Markdown or txt (WeChat does not support, direct publishing may be chaotic), format the publication |
- **`aiforge.toml` Configuration Items**
| Configuration Item | Description |
|----------------------------|--------------------------------------------------------------------------|
| **default_llm_provider** | Use model provider (default OpenRouter), which may differ from the model used by CrewAI |
| **api_key** | API Key of the model provider (required) |
| **Other Optional** | Configure other parameters as needed (optional), refer to UI interface instructions for specifics |
> *1. For detailed configuration information of aiforge.toml, refer to the [AIForge](https://github.com/iniwap/AIForge) project homepage*
> *2. The configuration management interface provides detailed explanations of key parameters (it is recommended to run in UI interface mode)*
> *3. ⚠️ WeChat official account AppID/AppSecret and the API KEY of the large model provider are required; others can be set to default*
## 🚀 Quick Start
### Development Mode
1. Clone the repository:
- `git clone https://github.com/iniwap/AIWriteX.git`
2. Install dependencies:
```shell
pip install uv
uv venv
uv pip install -r requirements.txt
```
3. Configure `config.yaml` and `aiforge.toml` (*WeChat Official Account AppID/AppSecret, API KEY of the large model provider*)
4. Run:
- With UI: `python .\main.py` (**Recommended**)
- Without UI: `python -m src.ai_write_x.crew_main` (**Does not support article, template, and image management**)
### Software Mode
1. Please download `AIWriteX_Cloud_Version_Setup.exe` from the cloud drive 👇 and install it.
| Cloud Drive Type | Download Link | Extraction Code | Version | Latest |
|-----------------------------|--------------------------------------------------------------------------------------------------------|-----------------|---------|------------|
| **Baidu Cloud** |[Win](https://pan.baidu.com/s/1tALycrUn36j5DdlFvH7c4A?pwd=iy1q) / [Mac](https://pan.baidu.com/s/1R7IJXdqLVL23yDHPOVyYiw?pwd=v32x) |iy1q / v32x |V2.2.1 |✅ |
| **China Mobile Cloud** |[Win](https://yun.139.com/shareweb/#/w/i/2pU918rU9Ln0e) / [Mac](https://yun.139.com/shareweb/#/w/i/2pU91bs7oT780) |6mdn / 0dy3 |V2.2.1 |✅ |
| **Google Drive** |[Win](https://drive.google.com/file/d/1rXohuAa0ZA9rUqqySIWm5OEPpbzxXREr/view?usp=sharing) |/ |V2.2.1 |✅ |
| **Microsoft OneDrive** |[Win](https://1drv.ms/u/c/c831e3cc9be11110/EVlmFdF8zWJPi7F0PS8i7JEBxXTZa1ett7YaKzgdhmHSFg?e=i4Vuzi) |/ |V2.2.1 |✅ |
2. Open the software and configure the necessary settings (*WeChat Official Account AppID/AppSecret, API KEY from the large model provider*).
3. Click `Start Execution`.
## 🔍 Troubleshooting
When encountering issues, please check the logs according to the operating mode and submit [Issues](https://github.com/iniwap/AIWriteX/issues)
### Frequently Asked Questions
Please check the `close` (closed) [Issues](https://github.com/iniwap/AIWriteX/issues?q=is%3Aissue%20state%3Aclosed) to learn about common problems that have been encountered and resolved by others.
## 🔮 WeChat Official Account Template Effect Preview
The following are meticulously fine-tuned, adapted, and published WeChat Official Account templates, covering multiple topic categories. Feel free to preview!
### Built-in Local Template List
- Category Templates
| Category | Template Name | Preview Link | Applicable Topics |
|----------------|---------------|-----------------------------------|----------------------------------------|
| **Classic Display** | t1 | [Click to Preview](https://mp.weixin.qq.com/s/KhKVRLGxbXceuHShnaUpOg) | **Gemini3 generates comic strips from an article** |
| Technology & Digital | t1 | [Click to Preview](https://mp.weixin.qq.com/s/UCjBHaZ_EZVBdEaSEH-6mQ) | Cutting-edge technology and digital reviews |
| Finance & Investment | t1 | [Click to Preview](https://mp.weixin.qq.com/s/uTfYVXUG3_bjqSZ-uuJKeg) | Investment trends and financial news |
| Education & Learning | t1 | [Click to Preview](https://mp.weixin.qq.com/s/DOr7sSBQ2sYSqu4WmlH__g) | Learning methods and educational news |
| Health & Wellness | t1 | [Click to Preview](https://mp.weixin.qq.com/s/ZG6SFUYSZlrxyRw6_GH9yg) | Tips for a healthy lifestyle |
| Food & Travel | t1 | [Click to Preview](https://mp.weixin.qq.com/s/Lw29haJDk4uKODh7rlBOrw) | Food recommendations and travel guides |
| Fashion & Lifestyle | t1 | [Click to Preview](https://mp.weixin.qq.com/s/ZgeIbl7l0KC1ex9ybrZBRg) | Fashion trends and lifestyle |
| Career Development | t1 | [Click to Preview](https://mp.weixin.qq.com/s/-jJ-OxCr7BMaaYY68vSecQ) | Workplace skills and career planning |
| Emotional & Psychological | t1 | [Click to Preview](https://mp.weixin.qq.com/s/2j-C1tBWkpYIQhhR6tOwSg) | Emotional stories and psychological insights |
| Entertainment & Gossip | t1 | [Click to Preview](https://mp.weixin.qq.com/s/3YeEH2Nvhsw8JqHIV0tftQ) | Latest entertainment news |
| News & Current Affairs | t1 | [Click to Preview](https://mp.weixin.qq.com/s/M_l2LCJjiGmCWRvSm7lYvA) | Global hotspots and current affairs analysis |
- Other Templates
| Category | Template Name | Preview Link | Applicable Topics |
|----------------|-----------------|----------------------------------|----------------------------------------|
| Other | template1 | [Click to Preview](https://mp.weixin.qq.com/s/9MoMFXgY7ieEMW0kqBqfvQ) | General template, no style restrictions |
| Other | template2 | [Click to Preview](https://mp.weixin.qq.com/s/0vCNvgbHfilSS77wKzM6Dg) | General template, no style restrictions |
| Other | template3 | [Click to Preview](https://mp.weixin.qq.com/s/ygroULs7dx5Q54FkR8P0uA) | General template, no style restrictions |
| Other | template4 | [Click to Preview](https://mp.weixin.qq.com/s/-SexfJ1yUcgNDtWay3eLnA) | General template, no style restrictions |
| Other | template5 | [Click to Preview](https://mp.weixin.qq.com/s/pDPkktE_5KnkQkJ1x2-y9Q) | General template, no style restrictions |
| Other | template6 | [Click to Preview](https://mp.weixin.qq.com/s/7F_Qdho-hzxeVV6NrsPmhQ) | General template, no style restrictions |
| Other | template7 | [Click to Preview](https://mp.weixin.qq.com/s/ug7NseZDziDMWBVwe3s1pw) | General template, no style restrictions |
| Other | template8 | [Click to Preview](https://mp.weixin.qq.com/s/uDjKVrWop4XNrM-csQ-IKw) | General template, no style restrictions |
| Other | template9 | [Click to Preview](https://mp.weixin.qq.com/s/EVhL67x8w35IuNnoxI1IEA) | General template, no style restrictions |
| Other | template10 | [Click to Preview](https://mp.weixin.qq.com/s/pDN5rgCgz0CbA8Q92CugYw) | General template, no style restrictions |
### Fully Automated Article Posting Effect Preview
Using local search and AIForge search to generate timely WeChat official account article effect previews:
| Type | Template Usage | Preview Link | Description |
|----------------|----------------|----------------------------------|---------------------------------------|
| Automated Posting | No Template Used | [Click to Preview](https://mp.weixin.qq.com/s/KI4yHYrjAt8hd_nUEZP8kA) | Article generated by AI based on requirements, no local template used |
| Automated Posting | Using template9 | [Click to Preview](https://mp.weixin.qq.com/s/1XPMUPR09Ipuzm_yXgAvKw) | Using local template template9, visual effect optimized |
| Automated Posting | Using Category Template | [Click to Preview](https://mp.weixin.qq.com/s/Dys7eszxP33k6tonXMO1VA) | Specified category `健康养生` (Health and Wellness), perfectly presented |
### Comparison of WeChat Display Effects in Light/Dark Mode
| Type | Theme Mode | Preview Link | Description |
|----------------|------------|------------------------------------------------------------------|--------------------------------------------------|
| Manual Post | Light | [Click to Preview](https://mp.weixin.qq.com/s/GOiOxGiym1dgqA77wrrFLw) | Best template for browsers, but margins appear too large on mobile |
| Manual Post | Light | [Click to Preview](https://mp.weixin.qq.com/s/MFKPQIBdldyC_dxcpooOSw) | Effect after uniform margin adjustment, looks more compact on mobile, but loses original design effect |
| Manual Post | Dark | [Click to Preview](https://mp.weixin.qq.com/s/jOWDpRSAw9twSptzZbBODg) | Original version is dark, but gets poorly converted when sent to WeChat (looks bad), instead displays normally in light mode |
> *1. The adapted templates can display well on WeChat Official Accounts, and those interested can continue to fine-tune the built-in templates (such as margins, etc.)*
> *2. Currently, only templates that are **not yet adapted** need adaptation to display perfectly (configuration **category random** may randomly select an unadapted template)*
> *3. Currently, templates do not handle dark mode well, which is related to WeChat's rigid processing*
## 📌 Other Notes
### About WeChat Official Accounts
The following is an explanation of issues related to WeChat Official Account development and automated posting:
- **CSS Limitations**:
- When WeChat publishes articles, it removes `position: absolute` (but retains `position: relative`), so alternative layouts must be used to achieve similar effects.
- Animation support is limited: `animateMotion` is available, but `animate` only supports opacity changes, which require further testing (for example, the animation part of template1 is supported).
- `<button>` and `background: url` will be automatically removed.
- The `id` of `<linearGradient id="catGradient">` will be removed, causing animations to fail.
- `background: linear-gradient(90deg, #4b6cb7 0%, #ff9a9e 100%); -webkit-background-clip: text; color: transparent;` does not support gradients in dark mode on mobile/computer themes, but supports in light mode.
- WeChat's dark mode will automatically add `js_darkmode__`, which will cause the background color to fail, and the dark mode effect is generally poor (using !important to force the non-use of dark mode is ineffective and will be automatically removed).
- **Dark/Light Mode**: Currently, the generation is more inclined to be suitable for WeChat's light mode, while the dark mode effect is slightly worse. A better balance between the two needs to be found in the future.
- **Article Display Issues**: Published articles (for unverified accounts) will not appear in the official account article list, but followers will receive notifications (up to 3 articles daily).
- **⚠️ Permission Revocation**: Starting from July 2025, personal accounts, unverified corporate accounts, and accounts that do not support verification will lose the ability to publish drafts, and unverified official accounts may not be able to post automatically.
- **⚠️ WeChat Official Account IP Whitelist Issues**:
- The WeChat API requires the current IP to be added to the backend whitelist.
- Dynamic IPs need to manually update the whitelist or use a fixed IP proxy.
- Solution: Use a cloud server to forward requests or proxy WeChat API requests through Alibaba Cloud Function Compute (free, registration with Alibaba Cloud required).
- **Official Account Article List Display Issues**:
- Unverified accounts: The API cannot display articles in the official account list and can only be done through backend operations.
- Verified accounts: Must call the mass sending interface to display in the list. The is_to_all (True/False) and the specific situation of not calling the sendAll interface should be tested by each user, supporting configuration for these three situations.
- When is_to_all=False and calling the interface, tag_id (user tag group ID) seems to be required.
- For this, refer to the [official explanation](https://developers.weixin.qq.com/doc/service/guide/product/message/Batch_Sends.html) (it’s quite confusing, WDNMD, why is there such an outrageous product).
> **⚠️ Note**: After July 2025, unverified accounts may face restrictions on automated publishing (can only publish to drafts, requiring backend operations to publish drafts, which will then appear in the official account article list).
## 📩 Contact Us
For configuration details or to discuss expansion, customization features, and commercial licensing, please contact QQ 522765228.
## 📜 License
This project is open-sourced under the [Apache License 2.0](./LICENSE) and comes with additional usage restrictions, as detailed in the [NOTICE](./NOTICE) file.
- 👉**It has recently been discovered that someone is selling this project. Please respect intellectual property rights; this project is prohibited for commercial use and is limited to personal use only.**
