Machine King Labs is an AI research laboratory dedicated to exploring the intersection of artificial intelligence and human creativity. Director's Palette represents our investigation into how AI can augment and enhance the creative process in storytelling, visual production, and content creation.
- AI-Driven Narrative Analysis - How AI can break down stories into visual components
- Director-Specific Style Modeling - Capturing unique directorial voices in AI generation
- Multi-Modal Content Workflows - Seamless integration of text, visual, and production elements
- Human-AI Creative Collaboration - Optimal patterns for AI-assisted creative work
We believe the future of AI creativity tools should be open, collaborative, and accessible. This research platform is our contribution to the global creative community, and we invite developers, researchers, filmmakers, and creators to build upon our work.
Professional creative platform with multiple format options and credit system
Create page-by-page shot lists with consistent character illustrations and age-appropriate content
Professional story-to-shot conversion with AI character extraction and comprehensive shot generation
Full AI-powered shot generation pipeline with professional cinematography details
Note: Screenshots show actual production interface with AI-powered character consistency system, professional shot lists, and enterprise-grade creative tools. Features include real-time character extraction, professional shot generation, and comprehensive export capabilities.
Director's Palette transforms creative concepts into professional, production-ready shot lists using AI-powered director-specific styling. It bridges the gap between creative vision and practical production planning.
Transform written stories into cinematic shot lists with director-specific styling.
Features:
- AI Story Analysis - Extracts characters, locations, and props automatically
- Director Style Application - Choose from Nolan, Tarantino, Fincher, Gerwig, and more
- Reference Extraction - Identifies story elements for consistent representation
- Professional Export - Generate production-ready shot lists
Example Workflow:
Story Input → Reference Extraction → Director Selection → Shot Generation → Export
Create comprehensive music video breakdowns with artist integration and visual storytelling.
Features:
- Lyric Structure Analysis - AI breaks down songs into visual sections
- Artist Bank Integration - Detailed artist profiles with visual descriptions
- @artist Variable System - Flexible artist representation (name vs description)
- Music Video Director Styles - Hype Williams, Michel Gondry, Spike Jonze, and more
Example Workflow:
Lyrics + Artist → Video Concept → Director Style → Section Generation → Export
Generate reference images and manage visual assets for production.
Features:
- Gen4 Image Generation - Create reference images from text prompts
- Reference Library - Organize and manage visual assets
- Shot Queue Management - Process shots from Story/Music Video modes
- Template-Based Prompts - Use structured prompts for consistent results
Professional export capabilities with advanced formatting and template support.
Features:
- Bulk Export - Export all shots with custom prefix/suffix formatting
- Multiple Formats - Text, numbered lists, JSON, CSV
- Export Templates - Pre-built formatting for different production needs
- Variable Processing - Smart @artist and @director replacement
- Node.js 18+
- npm or yarn
- OpenAI API key (for AI generation)
- Replicate API key (for image generation, optional)
# Clone the repository
git clone https://github.com/taskmasterpeace/ImgPromptGen.git
cd ImgPromptGen
# Install dependencies
npm install
# Set up environment variables
cp .env.example .env.local
# Add your API keys to .env.local
# Run development server
npm run dev# Required for AI story/music video generation
OPENAI_API_KEY=sk-your-openai-key-here
# Optional for image generation
REPLICATE_API_TOKEN=r8-your-replicate-token-here
# Application configuration
NEXT_PUBLIC_APP_NAME=Director's Palette- Enter a story in the Story Mode textarea
- Select a director (try Christopher Nolan or David Fincher)
- Click "Extract Story References" to identify characters and locations
- Review and configure extracted elements
- Generate shots and review the results
- Export all shots with professional formatting
- Switch to Music Video mode
- Enter song lyrics (or use a sample template)
- Add artist information from Artist Bank
- Include visual description for the artist
- Generate video breakdown and review sections
- Toggle between @artist and description views
- Export all shots with music video formatting
- GPT-4 Integration for intelligent content analysis and generation
- Director-Specific Prompting with carefully crafted style guidelines
- Context-Aware Generation that maintains consistency across shots
- Multi-Stage Processing for complex creative workflows
- Smart Templates for rapid content creation and testing
- Variable Replacement with @artist, @director, @location tags
- Export Templates for professional formatting consistency
- Prompt Templates for image generation with tag replacement
- Bulk Operations for production-scale projects
- Multiple Export Formats for different team members
- Cross-Browser Compatibility with clipboard and file operations
- Mobile-Responsive Design for field work and remote collaboration
- Framework: Next.js 15 with App Router
- Language: TypeScript 5
- UI: React 19 + Tailwind CSS 4 + shadcn/ui
- State Management: Zustand with persistence
- Database: IndexedDB (browser-based)
- AI: OpenAI GPT-4 via AI SDK
- Image Generation: Replicate API
/app- Next.js App Router with server actions/components- Modular React components with TypeScript/lib- Core business logic and utilities/stores- Zustand state management stores/hooks- Custom React hooks for common operations
- Modular Design - Easy to extend and experiment with
- Comprehensive Testing - Unit, integration, and functionality tests
- Flexible Configuration - Adaptable to different research directions
- Open Standards - Uses standard formats and protocols
- Director Style Modeling - Successfully implemented 15+ director styles
- Narrative Structure Analysis - AI accurately breaks down stories into chapters
- Music Video Generation - Complete lyric-to-visual mapping system
- Variable-Based Templating - Flexible artist and element representation
- Professional Export Workflows - Production-ready output formats
- Artist Visual Consistency - Maintaining character appearance across shots
- Cross-Modal Generation - Integrating text, image, and audio generation
- Collaborative AI Workflows - Multi-user creative sessions with AI
- Template Learning - AI learns from successful user templates
- Performance Optimization - Scaling to larger projects and teams
- Real-Time Collaboration - Live multi-user editing with AI assistance
- Advanced Image Generation - Consistent character appearance across multiple images
- Production Integration - Direct export to professional video editing tools
- Community Learning - AI learns from open source community contributions
- Multi-Language Support - International creative collaboration
We welcome contributions from researchers, developers, and creative professionals!
- Code Contributions - Features, bug fixes, performance improvements
- Research Insights - Share findings about AI-assisted creativity
- Template Libraries - Contribute story, music video, and export templates
- Documentation - Improve guides, add examples, translate content
- Testing - Help us test with real creative projects
- Community Building - Help others learn and use the platform
- Read our Contributing Guide
- Check the Development Setup
- Browse Open Issues
- Join our Research Discussions
- 15+ Director Styles implemented with unique characteristics
- 3 Major Workflow Modes (Story, Music Video, Post Production)
- 100+ Professional Templates for rapid content creation
- 4 Export Formats supporting different production needs
- Mobile-Responsive Design for modern creative workflows
- Sub-second Export Processing for production-scale projects
- Cross-Browser Compatibility with comprehensive fallbacks
- Comprehensive Test Coverage ensuring reliability
- Professional Documentation for contributor onboarding
- Modular Architecture enabling rapid feature development
# Generate professional shot list for indie film
Story: "Detective thriller with psychological elements"
Director: David Fincher
Export: Numbered list with technical specifications
Result: Production-ready shot list with crew requirements# Create music video breakdown for hip-hop track
Artist: Jay-Z (from Artist Bank)
Lyrics: [Verse/Chorus structure]
Director: Hype Williams
Export: JSON format with metadata for video team# Quick social media content planning
Template: "Hip-Hop Urban Vibe"
Customization: Local artist and locations
Export: Social media optimized shot descriptions
Distribution: Instagram, TikTok, YouTube ShortsMachine King Labs is an AI research laboratory focused on practical applications of artificial intelligence in creative industries. Our research spans:
- Creative AI Tools - Platforms that enhance human creativity
- Content Generation Systems - Multi-modal AI for media production
- Human-AI Collaboration - Optimizing creative partnerships with AI
- Open Source Research - Democratizing access to AI creativity tools
We believe AI should augment human creativity, not replace it. Our tools are designed to handle the technical and repetitive aspects of creative work, freeing humans to focus on vision, emotion, and artistic expression.
- Research Inquiries: research@machinekings.labs
- Technical Support: support@directorpalette.com
- Community: GitHub Discussions
- Documentation: Complete Guides
This project is open source and available under the MIT License.
When using Director's Palette in your projects or research, please include:
Powered by Director's Palette - Machine King Labs Research Project
https://github.com/taskmasterpeace/ImgPromptGen
- OpenAI for GPT-4 technology enabling intelligent content generation
- Replicate for image generation infrastructure
- Vercel for hosting and deployment platform
- shadcn/ui for beautiful, accessible UI components
- The Open Source Community for inspiring collaborative development
- 📖 Complete User Guide - Comprehensive application documentation
- 🧑💻 Developer Reference - Technical architecture and APIs
- 🎓 Step-by-Step Tutorial - Beginner-friendly walkthrough
- 🧪 Research Documentation - Academic papers and findings
- 🤝 Contributing Guidelines - How to contribute to the project
- 🐛 Issue Tracker - Bug reports and feature requests
Built with ❤️ by the Machine King Labs Research Team
Director's Palette - Where AI meets human creativity