Skip to content

Open-Self/Open-Self

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

πŸ§‘ OpenSelf

npm version License: MIT Node.js CI

Your AI clone. Your messages. Your machine.

OpenSelf turns your chat history into an AI clone that speaks exactly like you β€” on WhatsApp, Telegram, and Discord. Open source. Self-hosted. Bring your own API key.

OpenClaw is AI that does things for you. OpenSelf is AI that is you.


πŸ’‘ Why OpenSelf?

ChatGPT doesn't know your catchphrases. It doesn't know you greet your best friend with "Γͺ" and your mom with "dαΊ‘". It doesn't know you never write "Best regards" because you never have.

OpenSelf learns from YOUR real messages β€” your vocabulary, humor, emoji habits, abbreviations, and tone β€” then runs 24/7 as your digital twin.

I replaced myself on WhatsApp for a week. 156 messages. Nobody noticed. Read the story β†’


⚑ Quick Start

# Install
git clone https://github.com/Open-Self/open-self.git
cd open-self && npm install

# Feed your personality
npx openself feed --whatsapp ./my-chat-export.txt --name "You"

# Test your clone
npx openself test

# Go live
npx openself start --telegram
npx openself start --discord
npx openself start --whatsapp

🧠 How It Works

You export chat history β†’ Feed into OpenSelf β†’ Clone learns personality
β†’ Clone runs 24/7 on messaging apps β†’ Replies in YOUR voice
β†’ You review next morning "what did my clone say last night"
  1. Export your chat history (WhatsApp, Telegram, or write a bio)
  2. Feed it to OpenSelf β†’ AI learns your vocabulary, style, humor, catchphrases
  3. Start β†’ Your clone runs 24/7 on your messaging apps
  4. Review β†’ Check what your clone said each morning

🎭 Features

Feature Description
Personality Cloning Learns from your real messages, not generic AI
Human Mimicry Random reply delays, typing indicators, occasional typos
Safety First Boundaries, topic avoidance, review queue
SOUL.md Your personality in a file β€” editable and transparent
Multi-channel WhatsApp, Telegram, Discord β€” all ready
Clone Arena Two clones debate each other on any topic
Ghost Mode Clone auto-replies when you're offline
BYOK Claude, GPT, DeepSeek, or Ollama (free, local)
100% Local Your data never leaves your machine
Clone Score Test how accurately your clone mimics you
Shareable Badge SVG badge for your README or profile
Profile Sharing Export/import personality for cross-clone debates
RAG Memory Clone references past conversations naturally

πŸ“‹ CLI Reference

Command Description
openself setup Interactive setup wizard
openself feed Feed chat history to train personality
openself test Clone Score test or interactive chat
openself start Start clone on messaging apps
openself share --web "Talk to My Clone" web page
openself review Review what your clone said
openself arena Clone vs Clone debate
openself ghost Ghost Mode β€” clone replies when offline
openself profile Export/import personality profiles

πŸ“Š Clone Score

npx openself test

πŸ§ͺ Clone Score: 89% (Grade: A-)
Your clone is 89% you.

Share your score and challenge your friends!

🏟️ Clone Arena

Two clones debate each other β€” the viral "Clone vs Clone" feature:

npx openself arena --topic "CΓ  phΓͺ hay trΓ  sα»―a?"

Export a friend's profile and pit your clones against each other:

npx openself profile export        # Bundle your profile
npx openself arena --soul2 friend.openself  # Debate!

πŸ‘» Ghost Mode

Your clone replies when you're offline and stops when you're back:

npx openself ghost on    # Clone takes over
npx openself ghost off   # You're back
npx openself ghost       # Check status

πŸ”§ Setup

See the full Setup Guide for detailed instructions.

git clone https://github.com/Open-Self/open-self.git
cd open-self && npm install
cp .env.example .env    # Edit with your API key

Feed your personality:

npx openself feed --whatsapp ./chat-export.txt --name "Your Name"
npx openself feed --telegram ./telegram-export/result.json --name "Your Name"
npx openself feed --manual ./my-personality.md

Test & Go Live:

npx openself test                   # Clone Score test
npx openself test --interactive     # Chat with your clone
npx openself start --whatsapp       # QR code pairing
npx openself start --telegram       # Telegram bot
npx openself start --discord        # Discord bot

🏷️ Clone Score Badge

Add to your GitHub README or website:

[![OpenSelf Clone Score](http://localhost:3000/badge/yourname)](http://localhost:3000)

πŸ” Privacy

  • All data stays on YOUR machine
  • Chat history is processed locally
  • No cloud, no tracking, no telemetry
  • You control every boundary via SOUL.md
  • Review queue lets you approve uncertain replies

πŸ›  Supported LLM Providers

Provider Cost/message Setup
Claude (Anthropic) ~$0.003 API key
GPT-4o-mini (OpenAI) ~$0.0015 API key
DeepSeek V3 ~$0.0003 API key
Ollama (local) $0 Local install

Average user cost: $2-5/month (cheaper than a coffee β˜•)

πŸ“– Documentation

🀝 Contributing

PRs welcome! See CONTRIBUTING.md for guidelines.

git clone https://github.com/Open-Self/open-self.git
cd open-self && npm install
npx openself feed --whatsapp ./test-data/sample-whatsapp.txt --name "Harvey"
npx openself test

πŸ“œ License

MIT β€” do whatever you want with it.


OpenSelf β€” AI that IS you. πŸ§‘

About

Your AI clone. Your messages. Your machine. Open-source personality clone from chat history. BYOK (Claude/GPT/DeepSeek/Ollama). 100% local.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors