Create AI-powered digital clones that talk, think, and interact just like you! OpenClone uses cutting-edge deepfake technology to bring your personal AI avatars to life.
OpenClone lets you build personalized AI clones that can:
- 🗣️ Talk like you - Train with your voice for realistic speech
- 🎭 Look like you - Create lifelike video avatars
- 🧠 Think like you - Learn from Q&A sessions to capture your personality
- 💬 Chat naturally - Have conversations that feel authentic
Perfect for content creators, educators, businesses, or anyone who wants to create their digital twin!
OpenClone is a distributed system of specialized components working together:
The main web interface where users create and interact with their digital clones. Features user authentication, clone management, chat, and video generation orchestration.
Dual-database architecture with the main OpenClone database for user data and clones, plus a separate logging database. Supports vector embeddings for AI personality matching.
AI-powered deepfake video generation service that creates realistic talking head videos from still images and audio. Requires NVIDIA GPU for optimal performance.
Image segmentation service that removes backgrounds from user photos and performs image preprocessing for clone creation.
Monitoring dashboard that provides system insights, error tracking, and performance metrics across all OpenClone components.
DevOps infrastructure for deploying OpenClone to cloud environments, including Kubernetes clusters, databases, and monitoring systems.
Technical documentation and context files for AI-powered development assistance.
This project is designed to work with AI coding assistants. The repository includes AI-optimized documentation and integration tools:
- Open this repository in Claude Code
- Run /OpenClone/StartStopScripts/Claude/start.bat for shared development environment
- Use the cr command anytime to have Claude analyze and update documentation
AI Assistant documentation was created with Claude Code format.
Ready to create your first clone? Here's how:
- Download - Clone this repository to your computer
- Configure - Set up the environment variables below
- Launch - Run StartStopScripts/run-all.bat to start everything
- Create - Visit http://localhost:8080 and build your first clone!
Want to start individual services? Use these batch files:
- StartStopScripts/Database/start.bat - Start the database
- StartStopScripts/SadTalker/start.bat - Start video generation
- StartStopScripts/U-2-Net/start.bat - Start background removal
- StartStopScripts/OpenClone/start.bat - Start the main website
- Docker Desktop - For running all the AI services
- NVIDIA GPU (recommended) - Makes video generation much faster
- Node.js - For the website frontend
- OpenAI API Key - For AI conversations (Get one here)
- ElevenLabs API Key - For voice cloning (Get one here)
- Google OAuth - For user login (Setup guide)
- Create Your Clone - Upload a photo and record some audio samples
- Train the AI - Answer questions to teach your clone how to respond
- Generate Videos - Watch your clone come to life in realistic talking videos
- Chat & Share - Have conversations with your clone or let others chat with it
- 🎯 Quick Setup - Get started with batch scripts
- 🔒 Privacy First - Your data stays on your computer
- 🎨 Customizable - Train your clone's personality and responses
- 📱 Web Interface - Works in any modern web browser
- 🚀 GPU Accelerated - Optimized for quick video creation
- 💾 Export Options - Download your clone videos and conversations
- 📖 Documentation - Check the individual component README files for detailed setup
- 🐛 Issues - Found a bug? Create an issue in this repository
- 💡 Questions - Need help? Create an issue and we'll assist you
Ready to create your digital twin? Let's get started! 🚀
Copy these settings and update with your own values. You can set these in your system environment or create a .env file: