Skip to content

David-patrick-chuks/Director-X

Repository files navigation

DirectorX - AI-Powered Autonomous Movie Studio 🎬🤖

Overview

DirectorX is an AI-powered autonomous movie studio designed to generate short AI-driven animations based on user input. It enables content creators, filmmakers, and businesses to easily create and publish professional-quality animations in a fraction of the time it would typically take. DirectorX uses cutting-edge AI to create scripts, visuals, voiceovers, and animations, and can automatically post to platforms like YouTube, Instagram, Hashnode, and Medium. 🚀

Features ✨

  • 🎥 AI-Powered Short Film Creation: Generate fully automated short films from a topic or trend provided by the user.
  • ✍️ AI-Generated Scripts: AI generates scripts based on the user's input.
  • 🎨 Automated Animation Generation: Create professional animations from AI-generated scripts.
  • 🗣️ AI-Generated Voiceovers: Generate voiceovers to accompany the animations.
  • 📢 AI Auto-Publishing: Automatically post generated content to YouTube Shorts, Instagram Reels, X (Twitter), Hashnode, and Medium.
  • ⚙️ Custom Configuration: Fine-tune settings for specific content needs.
  • 🧠 Continuous Learning: The more data provided, the smarter the system becomes.
  • 💡 User-Submitted Content Support: Users can provide additional content for meme generation:
    • YouTube Video URL 🎥
    • Audio File 🎙️
    • Portfolio or Website Link 🌐
    • Token or Project Documents (Formats: PDF, DOC, DOCX, TXT) 📄
  • ☁️ Cloud-Based & Local Support: Runs locally or can be deployed in the cloud.

Supported Platforms 🌐

  • Social Media: YouTube video, Instagram video, X (Twitter), Hashnode,
  • Video Formats: MP4,
  • Document Formats: PDF, DOCX, TXT (for training the AI)

Getting Started 🚀

1️⃣ Installation

# Clone the repository
git clone https://github.com/david-patrick-chuks/directorx.git

# Navigate to the project folder
cd directorx

# Install dependencies
npm install  # or yarn install

### 2️⃣ Environment Setup

Create a `.env` file in the root directory and configure the following:

```env
YOUTUBE_API_KEY=your_youtube_api_key
INSTAGRAM_API_KEY=your_instagram_api_key
TWITTER_API_KEY=your_twitter_api_key
HASHNODE_API_KEY=your_hashnode_api_key
OPENAI_API_KEY=your_openai_api_key
MONGODB_URI=your_mongodb_connection_string

3️⃣ Running DirectorX Locally

# Start the server
npm run dev  # or yarn dev

4️⃣ Deploying DirectorX Online

To keep DirectorX running 24/7, deploy it using Vercel, AWS Lambda, or Google Cloud Functions.

# Deploy using Vercel
vercel deploy

How to Use DirectorX 🧠

1️⃣ Generate a Short Film 🎬

Submit a POST request to create a short film based on a topic or trend.

POST /generate/
{
  "prompt": "generate a video for my crypto token 'Baby-Cat'",
}

2️⃣ Auto-Publish to Social Media 📢

After generating a short film, DirectorX can automatically post it to the selected platform.

POST /post/film
{
  "platform": "youtube",
  "content": "Your film content",
  "video": "video_url"
}

3️⃣ Check DirectorX's Training Data

GET /train/data

4️⃣ Delete Training Data

DELETE /train/data
{
  "type": "document"
}

API Endpoints 📡

🔹 Generate a Short Film

POST /generate/film
{
  "topic": "your_topic",
  "trend": "your_trend"
}

🔹 Post to YouTube

POST /post/youtube
{
  "content": "Your YouTube video description",
  "video": "video_url"
}

🔹 Post to Instagram

POST /post/instagram
{
  "content": "Your Instagram post content",
  "image": "image_url"
}

🔹 Post to X (Twitter)

POST /post/twitter
{
  "content": "Your Twitter post content"
}

🔹 Post to Hashnode

POST /post/hashnode
{
  "content": "Your blog content"
}

Future Enhancements 🌟

  • AI-generated captions & hashtags for social media
  • Expansion to additional platforms like TikTok and LinkedIn
  • Live engagement analytics dashboard

Contribution 🤝

Want to contribute? PRs are welcome!

  1. Fork the repository.
  2. Create a feature branch: git checkout -b feature-name
  3. Commit your changes: git commit -m "Add new feature"
  4. Push and create a PR.

License 📜

DirectorX is released under the MIT License.


Contact 📧

💬 Twitter/X: BugHunter.dev💬 Email: davidchuksdev@gmail.com

About

DirectorX is an AI-powered autonomous movie studio that generates short AI-driven animations. It automates scriptwriting, animation, and voiceover creation, with the ability to auto-publish content to platforms like YouTube, Instagram, Hashnode, and Medium. The project runs both locally and in the cloud, offering seamless content

Resources

Stars

12 stars

Watchers

1 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors