🎯 What Makes CloneMe Special?

Ever wished you could be everywhere at once? CloneMe makes it possible. Transform any AI into your perfect digital twin that learns, remembers, and responds just like you would - but smarter and always available.

🎭 CloneMe in action - natural AI conversations with memory and personality

✨ Why Developers Love CloneMe

💡 Pro Tip: CloneMe isn't just another chatbot - it's your digital presence that learns and evolves with every conversation.

🌐 Platform & AI Support

🚀 Quick Start

📋 What You'll Need

⚡ Lightning Installation

Step 1: Get the Code

git clone https://github.com/vibheksoni/cloneme.git cd cloneme

Step 2: Magic Setup ✨

python scripts/setup.py

🎯 Our autonomous installer handles everything:

- ✅ Python compatibility check

- ✅ Virtual environment creation

- ✅ Dependency installation

- ✅ Directory structure setup

- ✅ Configuration templates

🔧 Configuration Made Simple

Step 3: Configure Your Clone

# 🎮 Platform Setup
PLATFORM=discord
DISCORDSELFTOKEN=yourdiscordselftokenhere
🤖 AI Brain Configuration  
AI_PROVIDER=openai                    # Choose your AI provider
AIAPIKEY=yourapikey_here         # Your API credentials
AI_MODEL=gpt-4                       # Model selection
AIPROFILE=defaultprofile           # Personality profile
🎬 Optional Enhancements
GIPHYAPIKEY=yourgiphyapikeyhere    # For GIF reactions
AZUREOPENAIENDPOINT=yourazureendpoint # For Azure OpenAI users

{
  "profiles": {
    "default": {
      "required": {
        "username": "YourUsername",
        "name": "Your Display Name"
      },
      "personality_traits": {
        "humor_style": "witty and sarcastic",
        "communication_style": "casual but intelligent",
        "interests": ["AI", "Gaming", "Technology"]
      },
      "custom_behaviors": {
        "emoji_usage": "moderate",
        "response_length": "concise",
        "technical_depth": "intermediate"
      }
    }
  }
}

🎉 Launch Your Clone

python main.py

🎊 Success! Your AI clone is now live and learning. Watch the magic happen in real-time!

Documentation

| Document | Description | |----------|-------------| | Settings Guide | Complete settings configuration with hot-reload | | Profile System | Create dynamic AI personalities with flexible schemas | | Memory System | Intelligent memory with quality filtering and deduplication | | Message Flow | Detailed breakdown of message processing pipeline |

Architecture

System Design

graph TB
    subgraph "Platform Layer"
        A[Discord] --> D[Platform Manager]
        B[Telegram*] --> D
        C[Twitter*] --> D
    end
    
    subgraph "Core AI Layer"
        D --> E[Decision Engine]
        E --> F[Memory System]
        F --> G[Response Generator]
    end
    
    subgraph "AI Providers"
        G --> H[OpenAI]
        G --> I[Anthropic]
        G --> J[Google]
        G --> K[Groq]
        G --> L[Ollama]
    end

Core Components

• Platform Manager: Handles platform-specific message processing
• Decision Engine: Determines when and how to respond
• Memory System: Manages long-term conversation memory
• Profile Manager: Handles personality configuration and hot-reloading
• AI Provider Interface: Abstracts different AI service providers

Extensibility

The system uses a BasePlatform abstraction for easy platform expansion:

class NewPlatform(BasePlatform):
    def getplatformname(self) -> str:
        return "new_platform"
async def sendmessage(self, chatid: str, content: str) -> bool:         # Platform-specific implementation         pass
def convertplatformmessage(self, platform_msg, chat, sender) -> Message:         # Convert to generic Message object         pass

Memory System

The intelligent memory system focuses on quality over quantity:

graph LR
    A[User Message] --> B[Quality Filter]
    B --> C[Deduplication Check]
    C --> D[Memory Storage]
    D --> E[Context Retrieval]
    E --> F[Natural Response]
    
    G[Memory Cleanup] --> D
    H[Importance Ranking] --> G

What it remembers:

• Names, ages, locations, occupations
• Preferences, hobbies, relationships
• Important life events and goals

• Temporary states and requests
• Meta-questions about the AI
• Low-quality or redundant information

• Quality-based filtering
• Automatic deduplication
• Importance-based cleanup
• Context-aware retrieval

Profile System

Create sophisticated AI personalities with unlimited customization:

• Hot-reload: Changes apply instantly without restart
• Flexible schema: Required core fields plus unlimited custom fields
• Multi-profile support: Switch between different personalities
• Validation: Automatic schema checking

Security Features

• Prompt injection protection: Advanced filtering of malicious inputs
• Rate limiting: Configurable participation controls
• Local data storage: No cloud sync, user-controlled data
• Secure configuration: Environment variable protection

💬 Community & Support

💡 Pro Community Tip: Our most active contributors often become platform maintainers and get early access to new features!

Roadmap & Contributing

Current Development Status

graph TB
    subgraph "✅ Completed"
        A[Discord Implementation]
    end
    
    subgraph "🚧 In Progress"
        B[Telegram Bot API]
        C[Voice Message Support]
    end
    
    subgraph "📋 Planned - High Priority"
        D[Twitter/X Integration]
        E[Web Dashboard]
        F[Image Understanding]
    end
    
    subgraph "🔮 Future Development"
        G[WhatsApp Business API]
        H[Multi-language Support]
        I[Docker Deployment]
        J[Cloud Templates]
    end
    
    A --> B
    B --> D
    C --> F
    E --> I

🌟 We're Actively Recruiting Talented Contributors!

Ready to shape the future of AI personalities? CloneMe is more than just a project - it's a movement. We're building the next generation of AI interaction, and we need passionate developers, designers, and AI enthusiasts to join our mission.

High-Priority Implementations Needed

How to Contribute

Getting Started

• Fork and Setup

# Fork the repository on GitHub, then clone your fork
   git clone https://github.com/yourusername/CloneMe.git
   cd CloneMe
   
   # Set up development environment
   python scripts/setup.py
   
   # Install development dependencies
   pip install -r requirements-dev.txt

• Development Workflow

# Create feature branch
   git checkout -b feature/platform-telegram
   
   # Make your changes and test
   python -m pytest tests/
   
   # Run the application
   python main.py

• Contribution Guidelines

🏆 Contributor Recognition & Rewards

🎉 Special Perks: Top contributors get exclusive CloneMe swag, direct access to the core team, and opportunities to speak at AI conferences!

Troubleshooting

Common Issues

# Windows    venv\Scripts\activate        # macOS/Linux    source venv/bin/activate

pip install --upgrade pip
   pip install -r requirements.txt

python --version  # Should be 3.11.6+

{      "participation_control": {        "threshold_percentage": 15,        "timewindowminutes": 20      }    }

Getting Help

License

This project is licensed under the MIT License with attribution requirements - see the LICENSE file for details.

Attribution Requirement: Any use, modification, or distribution must include proper attribution to the original CloneMe project and link to https://github.com/vibheksoni/cloneme