Project Info
Google: Best Use of Gemini; Nobel Era Group: Best Projects Leveraging LLM Agents Supported by Nobel Era Group & Berkeley RDI
DreamDirector
Inspiration
We love immersive experiences. We dreamed of a platform where you could not just imagine the story, but see it unfold like a movie with adaptive music that responds to your emotions. The latest advances in multimodal AI from Google, including Gemini, Imagen 3.0, Veo 2.0, and Lyria RealTime, gave us the tools to finally build it: a true AI storyteller that weaves narrative, visuals, and dynamic audio together in real time.
What it does
DreamDirector is your personal AI Cinematic Director. The entire experience starts with you; you can type in a prompt for any world you want to build, any story you want to tell. Whether it's a 'cyberpunk mystery' or a 'fantasy quest', our multi-agent AI system collaborates to bring that world to life. The system generates stunning 4K images with visual consistency tracking, produces cinematic 8-second video sequences for dramatic moments, and creates adaptive music that evolves with your story's emotional tone. Every choice you make matters, with the AI maintaining persistent memory of characters, locations, and world state across your entire journey.
How we built it
Architecture & Technology Stack Frontend (React 18 + Modern Web) React 18 with Vite for lightning-fast development Tailwind CSS with custom cinematic themes Framer Motion for advanced animations and transitions React Router Dom for seamless navigation Axios for API communication Backend (FastAPI + Python) FastAPI with async/await for high-performance API handling Uvicorn ASGI server with real-time capabilities Pydantic for data validation and type safety Python-multipart for media file handling CORS middleware for cross-origin support AI & Multi-Agent System (Google ADK + GenAI) Google ADK (Application Development Kit) for agent orchestration Google GenAI SDK with Gemini models for intelligent reasoning Google Imagen 3.0 for consistent visual generation Google Veo 2.0 for cinematic video sequences Google Lyria RealTime for streaming adaptive music Multi-Agent Workflow We architected DreamDirector as a team of specialized AI agents working through the Google ADK framework: Story Director Agent Orchestrates narrative flow using Gemini's reasoning capabilities Manages three-act story structure and pacing Generates meaningful user choices with preview consequences Maintains character development and plot consistency Visual Consistency Agent Uses Imagen 3.0 with character/location reference tracking Maintains visual DNA across all generated content Ensures professional cinematographic composition Applies consistent artistic style and color palettes Adaptive Music Composer Leverages Lyria RealTime for streaming audio generation Creates layered compositions (atmospheric, character, action themes) Responds to emotional tone and story tension in real-time Supports multiple genres from cyberpunk synthwave to orchestral fantasy Media Orchestrator Coordinates multi-modal generation timing Optimizes resource usage across Google's APIs Handles video generation with image seeds for consistency Manages media balance for optimal user experience User Choice System Our choice system goes beyond simple branching narratives: Dynamic Choice Generation where AI creates contextual choices based on current story state Visual Preview System where users see outcomes through generated imagery Persistent Consequences where every decision affects character relationships and world state Adaptive Difficulty where story complexity adjusts to user engagement patterns Memory Integration where choices influence future scene generation and character interactions
Challenges we ran into
Orchestrating multiple cutting-edge AI models in real-time presented significant challenges. Ensuring visual consistency across Imagen 3.0 generations required sophisticated prompt engineering and reference image tracking. Integrating Lyria RealTime's streaming audio with FastAPI's async architecture demanded careful threading and session management. The most complex challenge was building a coherent multi-agent system where each AI agent could communicate through structured function calls while maintaining narrative coherence and fluid user experience.
Accomplishments we're proud of
We successfully created the first truly multimodal storytelling engine that combines Gemini's reasoning, Imagen's visuals, Veo's cinematography, and Lyria's music into a seamless experience. Our multi-agent architecture represents a breakthrough in AI collaboration; each agent specializes in its domain while contributing to a unified creative vision. We're especially proud of our visual consistency system that maintains character appearance and world continuity across an entire story session, and our adaptive music system that creates Hollywood-quality soundtracks in real-time.
What we learned
This hackathon was a masterclass in practical multimodal AI engineering. We learned how to architect complex agent systems using Google ADK's tool framework, mastered advanced prompt engineering for consistent visual generation, and discovered the nuances of real-time audio streaming. Most importantly, we proved that sophisticated AI agent collaboration can create experiences far richer than any single model can do alone.
What's next
We envision expanding DreamDirector into a comprehensive creative platform. Our roadmap includes: Multiplayer Adventures with shared AI-crafted worlds for collaborative storytelling Creator Tools to allow users to define custom genres and fine-tune agent behaviors Extended Media Support for integration with more Google AI APIs as they become available Mobile Experience for native iOS/Android apps with offline story caching Community Features for story sharing, remixing, and collaborative world-building Submission for the UC Berkeley AI Hackathon 2025 - Creativity Track DreamDirector represents the future of AI-powered interactive entertainment, showcasing how multiple specialized agents can collaborate to create magical user experiences. Problem and Market Opportunity The creator economy demands high-quality multimedia content, but individual creators face immense time and cost barriers. DreamDirector democratizes cinematic storytelling by turning weeks of traditional production into seconds of AI-powered generation, making professional-quality interactive media accessible to everyone. Multi-Agent Innovation and Technical Excellence Our core innovation is a sophisticated multi-agent system built on Google ADK that goes far beyond simple prompt chaining. Each agent maintains specialized knowledge domains and communicates through structured function calls with persistent state management. This architecture enables complex creative workflows while maintaining reliability and coherence. Scalability and Impact Built on Google's cloud-native APIs with async FastAPI architecture, DreamDirector is designed for massive scale. Our vision is to keep the core storytelling experience free for creators, students, and hobbyists while building sustainable revenue through enterprise API licensing for professional studios seeking to integrate our multi-agent creative engine into their workflows. DreamDirector, in short, is the foundation for the next generation of interactive entertainment.
π¬ DreamDirector - AI-Powered Cinematic Storytelling
"Tell me your dream story and I'll make you live it"
DreamDirector is a revolutionary multimodal storytelling experience that combines cutting-edge AI technologies to create infinite, interactive narratives with real-time visual, audio, and video generation. Built for the UC Berkeley AI Hackathon 2025, this project represents the future of immersive digital storytelling.
β¨ Key Features
π€ Multi-Agent AI System
- Story Director Agent - Orchestrates narrative flow and pacing
- Visual Consistency Agent - Maintains character and location coherence
- Music Composer Agent - Creates adaptive, emotionally-responsive soundtracks
- Media Generation Agent - Coordinates real-time content creation
π Real-Time Media Generation
- Cinematic Images - Google Imagen 3.0 with visual consistency tracking
- Dynamic Videos - Google Veo 2.0 for scene-to-scene transitions
- Adaptive Music - Google Lyria RealTime for contextual soundscapes
- Professional Quality - 4K visuals, 48kHz audio, cinematic composition
π― Interactive Storytelling
- Choice-Driven Narratives - Every decision shapes your unique story
- Persistent Memory - Characters and world state maintained across scenes
- Emotional Intelligence - AI responds to user personality and preferences
- Infinite Replayability - No two adventures are ever the same
π οΈ Technology Stack
Frontend Technologies
- React 18 - Modern component-based UI framework
- Vite - Lightning-fast build tool and development server
- React Router Dom - Client-side routing and navigation
- Framer Motion - Advanced animations and interactive transitions
- Tailwind CSS - Utility-first styling with custom cinematic theme
- Lucide React - Beautiful, customizable icon library
- Axios - Promise-based HTTP client for API communication
Backend Technologies
- FastAPI - High-performance Python web framework
- Uvicorn - Lightning-fast ASGI server with async support
- Pydantic - Data validation and settings management
- Python Multipart - File upload and media handling
- Python-dotenv - Environment configuration management
- CORS Middleware - Cross-origin resource sharing support
AI
- Google ADK (Application Development Kit) - Core AI agent orchestration
- Google GenAI SDK - Multimodal content generation APIs
- Google Imagen 3.0 - State-of-the-art image generation with consistency
- Google Veo 2.0 - Advanced video generation from image seeds
- Google Lyria RealTime - Streaming music composition and generation
- Streamlit - Interactive AI demonstrations and prototyping
Development & Build Tools
- PostCSS - CSS transformation and optimization
- Autoprefixer - Automatic vendor prefix management
- Git - Version control and collaboration
- Node.js - JavaScript runtime for frontend tooling
π¨ AI Agents & Capabilities
π Narrative Director
- Story Architecture - Creates compelling three-act structures
- Character Development - Maintains personality consistency
- Plot Progression - Balances pacing and dramatic tension
- Choice Generation - Crafts meaningful decision points
π¬ Visual Consistency Engine
- Character References - Maintains visual identity across scenes
- Location Memory - Ensures environmental continuity
- Style Coherence - Applies consistent artistic direction
- Scene Composition - Professional cinematographic framing
π΅ Adaptive Music Composer
- Emotional Scoring - Music responds to story mood and tension
- Real-Time Generation - Seamless audio streaming during gameplay
- Layered Composition - Combines atmospheric, character, and action themes
- Genre Adaptation - Matches musical style to story setting
π― Media Orchestrator
- Generation Optimization - Balances quality with performance
- Content Synchronization - Coordinates multi-modal generation
- Resource Management - Efficient GPU and API usage
- Quality Assurance - Ensures professional-grade output
π Project Highlights
Innovation
- Multi-Modal AI Collaboration - First-of-its-kind agent orchestration
- Real-Time Generation - Live content creation during user interaction
- Visual Consistency - Breakthrough character/location memory system
- Adaptive Soundscapes - Dynamic music that evolves with narrative
Technical Excellence
- Async Architecture - Non-blocking, high-performance backend
- Streaming APIs - Real-time audio/video generation pipeline
- State Management - Persistent game world across sessions
- Error Resilience - Graceful handling of AI generation failures
User Experience
- Cinematic Interface - Movie-quality visual design and animations
- Intuitive Navigation - Seamless story progression and choice making
- Performance Optimized - Fast loading, smooth interactions
- Accessibility - Responsive design for all device types
π Competition Context
UC Berkeley AI Hackathon 2025 - Creativity Track
DreamDirector represents a new paradigm in interactive entertainment, combining Google's most advanced AI technologies into a cohesive, magical user experience. The project showcases the potential of multi-agent AI systems working in harmony to create something greater than the sum of their parts.
π Architecture Overview
βββββββββββββββββββ ββββββββββββββββββββ βββββββββββββββββββ
β React Frontend β β FastAPI Backend β β AI Agent System β
β β β β β β
β β’ Story UI βββββΊβ β’ API Routes βββββΊβ β’ Story Directorβ
β β’ Media Gallery β β β’ Media Serving β β β’ Visual Agent β
β β’ Choice System β β β’ State Mgmt β β β’ Music Agent β
β β’ Animations β β β’ File Handling β β β’ Media Agent β
βββββββββββββββββββ ββββββββββββββββββββ βββββββββββββββββββ
β
βΌ
βββββββββββββββββββ
β Google AI APIs β
β β
β β’ Imagen 3.0 β
β β’ Veo 2.0 β
β β’ Lyria RT β
β β’ GenAI SDK β
βββββββββββββββββββ
Showcasing the future of AI-powered interactive entertainment
Analysis
View
Metric
- 8
- 1
Figures cover GitHub contributors during the hackathon window. A co-authored commit counts in full for each author, so per-member totals add up to more than the whole-team figures.
Technology
- CSSIn code
- FastAPIIn code
- HTMLIn code
- JavaScriptIn code
- PythonIn code
- ReactIn code
- StreamlitIn code
- Tailwind CSSIn code
8 of 8 appear in the indexed code.
AI coding agents
No AI coding agent signals were found in this repository.
Detected from committed agent config files and commit authorship. Absence of a signal is not proof an agent was unused.
Codebase size
Source size
560 KB
Source files
40
Counts recognized source files only; vendored directories, binaries and lockfiles are excluded, so this is smaller than the repository on disk.
Repository
Abdullah0x0/dreamdirector
54 files Β· 675 KB Β· @ 79ec504
Structure
Interface
10 files Β· 19%Screens, components and styles rendered to the user.
Application logic
25 files Β· 46%Domain rules, services and shared utilities.
+1 more
Supporting
Layers are inferred from where files sit in the tree, not from reading the code. A project that names its directories unconventionally will read oddly here β open the file browser to check anything the diagram implies.
Languages
- JavaScript54%
- Python40%
- Markdown5%
- HTML0%
- CSS0%
- Shell0%
Share of indexed source by file size. Binary and vendored files are excluded.
Dependencies
package.json
npm Β· 13- axios
- framer-motion
- lucide-react
- react
- react-dom
- react-router-dom
- +7 more
backend/requirements.txt
pypi Β· 10- fastapi
- google-adk
- google-genai
- pillow
- pydantic
- python-dotenv
- python-multipart
- requests
- streamlit
- uvicorn[standard]
agents/requirements.txt
pypi Β· 7- asyncio
- google-adk
- google-genai
- pillow
- python-dotenv
- requests
- streamlit
Declared in the repositoryβs manifests at the indexed commit. A declared package is not proof it is used, and runtime dependencies are listed first.
This projectβs features have not been analysed yet.
Export this project's context (description, README, evidence, key source files) to chat with an AI agent elsewhere.