ytb-books: Book Content Automation with Neo4j GraphRAG

Automate Book Episode Generation End-to-End

ytb-books transforms how you create educational video content from books. This open-source skill pack implements a complete Neo4j GraphRAG pipeline that automatically generates YouTube episodes from book content — from chunking and scenario planning to image rendering, voice synthesis, and final video composition.

Unlike traditional content creation tools, ytb-books leverages graph database technology to understand relationships between concepts in your source material. The Neo4j service stores documents, episodes, and scenes in a connected structure that enables intelligent next-episode recommendations based on GraphRAG patterns.

LaTeX Math Rendering for Educational Content

For STEM educators and technical creators, ytb-books includes robust LaTeX math rendering capabilities. The MathFormulaService converts LaTeX expressions into high-quality PNG images for video overlays or Unicode text for subtitles and TTS narration.

The implementation uses MathJax v4 with careful configuration to avoid Node.js crashes. It renders TeX expressions to SVG first, then converts to PNG using Sharp for optimal quality. The service automatically adjusts fill colors for dark backgrounds and removes unnecessary MathJax container wrappers to ensure compatibility with video composition workflows.

Neo4j Graph Database Integration

The core of ytb-books is its Neo4j GraphDB service that manages your book content at three levels: Documents, Episodes, and Scenes. Each document represents a book or source material, episodes are generated content sequences, and scenes are individual video segments.

The graph schema establishes clear relationships: (Document) -[:HAS_EPISODE]-> (Episode) -[:HAS_SCENE]-> (Scene). This structure enables powerful queries for content discovery and ensures episode sequencing through (Episode) -[:NEXT]-> (Episode) relationships.

Complete Technical Stack

ytb-books integrates multiple technologies into a cohesive workflow:

• Neo4j Driver: For graph database operations with proper transaction handling
• NanoBanana API: For generating custom illustrations and scene images
• FFmpeg: For video composition and processing
• Gemini TTS: For high-quality voice synthesis with automatic style selection
• MathJax v4: For LaTeX rendering without crashing Node.js processes

Installation and Setup

Getting started with ytb-books is straightforward:

# Install the marketplace plugin
/plugin marketplace add https://github.com/clickaround/marketplace

# Install ytb-books
/plugin install ytb-books@clickaround

You'll need to configure your Neo4j instance connection details in the BOOKS_PROJECT_CONFIG file. The system requires a Neo4j database running at bolt://YOUR_NEO4J_HOST:7687 with appropriate credentials.

Use Cases and Applications

ytb-books is ideal for:

• Educational content creators developing math and science videos
• Technical writers automating documentation video generation
• Academic researchers creating accessible content from research papers
• Book publishers developing supplemental video content
• Online course instructors creating lecture series from textbooks
• Self-learners who want to convert their favorite books into engaging video content
• Content agencies building scalable educational video production pipelines
• Research institutions creating public-facing explanations of complex scientific concepts

Style System and Customization

ytb-books supports five distinct visual styles through a strategy pattern implementation:

• math_character (default): Optimized for mathematical content
• dark_academia: Classic academic aesthetic
• watercolor: Artistic, hand-drawn feel
• minimalist: Clean, modern presentation
• retro_comic: Playful, vintage comic book style

Adding new styles is simple: create a profile and register it in the system's registry. Each style includes specific configurations for image generation, typography, color schemes, and animation patterns to create a consistent visual identity across your content.

Open Source and Licensing

ytb-books is 100% free and open source under the MIT license. You can view, modify, and extend the source code at our GitHub repository. This transparency ensures you understand exactly how your content is being processed and gives you full control over your automation pipeline.

Performance and Scalability

The ytb-books architecture is designed for performance and scalability. The Neo4j GraphDB backend provides efficient querying capabilities even with large knowledge graphs containing thousands of documents and millions of relationships. The modular service design allows for horizontal scaling of individual components like image generation and TTS services.

Each service is implemented with proper error handling and retry mechanisms to ensure reliability in production environments. The system includes comprehensive logging and monitoring hooks to help you track pipeline performance and identify bottlenecks.

Community and Support

As part of the ClickAround Creator Pro ecosystem, ytb-books benefits from an active community of developers and content creators. The Discord community provides real-time support, feature requests, and collaboration opportunities. Regular updates and improvements are driven by community feedback and usage patterns.

The documentation is comprehensive and includes detailed installation guides, API references, and troubleshooting sections. All source code is well-commented and follows TypeScript best practices for maintainability.