3c58fd555b
New tools added to ToBeMigrated/ directory: ai_marketing_tools/: - ai_backlinker: AI-powered backlink generation - ai_google_ads_generator: Google Ads generation with templates ai_writers/: - ai_blog_faqs_writer: FAQ generation for blogs - ai_copywriter: Multiple copywriter frameworks (AIDA, PAS, 4C, 4R, etc.) - ai_finance_report_generator: Financial report generation - ai_story_illustrator: Story illustration - ai_story_video_generator: Story video generation - ai_story_writer: AI story writing - github_blogs: GitHub blog integration - speech_to_blog: Audio to blog conversion - twitter_writers: Twitter/X content generation - youtube_writers: YouTube content generation These tools are in ToBeMigrated/ for future migration to the main backend.
AI Story Illustrator
The AI Story Illustrator is a powerful tool that generates beautiful illustrations for stories using Google's Gemini AI. This module allows users to input stories via text, file upload, or URL, and automatically generates appropriate illustrations for different scenes in the story.
Features
- Multiple Input Methods: Input stories via direct text entry, file upload, or URL extraction
- Intelligent Scene Segmentation: Automatically divides stories into logical segments for illustration
- Customizable Illustration Styles: Choose from various artistic styles or define your own
- Scene Element Extraction: Analyzes story segments to identify key visual elements
- Multiple Export Options: Export as PDF storybook or ZIP archive of individual images
- Customizable Aspect Ratios: Support for different image dimensions (16:9, 4:3, 1:1)
- Advanced Settings: Control the number of segments to illustrate and other parameters
Usage
The Story Illustrator is integrated into the Alwrity platform and can be accessed through the main interface. The workflow consists of three main steps:
- Story Input: Enter your story text, upload a file, or provide a URL
- Illustration Settings: Configure the style, aspect ratio, and other parameters
- Generate & Export: Generate illustrations for all or individual segments and export the results
Technical Details
Dependencies
- Streamlit: For the user interface
- Gemini AI: For image generation
- BeautifulSoup: For URL text extraction
- ReportLab: For PDF generation (optional)
- PIL: For image processing
Key Functions
segment_story(): Divides a story into logical segments for illustrationextract_scene_elements(): Analyzes story segments to identify key visual elementsgenerate_illustration_prompt(): Creates detailed prompts for the AI image generatorcreate_illustration(): Generates an illustration for a story segmentcreate_storybook_pdf(): Combines story text and illustrations into a PDFcreate_zip_archive(): Creates a ZIP archive of individual illustrations
Example
from lib.ai_writers.ai_story_illustrator.story_illustrator import write_story_illustrator
# Run the Story Illustrator app
write_story_illustrator()
Best Practices
- Provide Clear Segments: The system works best with stories that have clear scene transitions
- Be Specific with Styles: More specific style descriptions yield better results
- Balance Text and Images: For best results, aim for segments of 100-500 words per illustration
- Review and Regenerate: If an illustration doesn't capture the scene well, use the regenerate option
Future Enhancements
- Support for more export formats (EPUB, HTML)
- Enhanced character consistency across illustrations
- Animation options for digital storytelling
- Voice narration integration
- Custom character design options
Troubleshooting
- If illustrations are not generating, check your internet connection and API access
- If PDF export fails, ensure ReportLab is installed (
pip install reportlab) - If URL extraction fails, try copying the text manually
- For large stories, consider processing in smaller batches
Credits
This module uses Google's Gemini AI for image generation and leverages various open-source libraries for text processing and document generation.