Second-Me README

The project's README from github.com/mindverse/Second-Me. As one markdown file: README.md.

Second Me

Homepage AI-native Memory AI-native Memory 2.0 Discord Twitter Reddit View FAQ

Our Vision

Companies like OpenAI built "Super AI" that threatens human independence. We crave individuality: AI that amplifies, not erases, YOU.

We’re challenging that with "Second Me": an open-source prototype where you craft your own AI self—a new AI species that preserves you, delivers your context, and defends your interests.

It’s locally trained and hosted—your data, your control—yet globally connected, scaling your intelligence across an AI network. Beyond that, it’s your AI identity interface—a bold standard linking your AI to the world, sparks collaboration among AI selves, and builds tomorrow’s truly native AI apps.

Tech enthusiasts, AI pros, domain experts, Join us! Second Me is your launchpad to extend your mind into the digital horizon.

Key Features

Train Your AI Self with AI-Native Memory (Paper)

Start training your Second Me today with your own memories! Using Hierarchical Memory Modeling (HMM) and the Me-Alignment Algorithm, your AI self captures your identity, understands your context, and reflects you authentically.

Scale Your Intelligence on the Second Me Network

Launch your AI self from your laptop onto our decentralized network—anyone or any app can connect with your permission, sharing your context as your digital identity.

Build Tomorrow’s Apps with Second Me

Roleplay: Your AI self switches personas to represent you in different scenarios.
AI Space: Collaborate with other Second Mes to spark ideas or solve problems.

100% Privacy and Control

Unlike traditional centralized AI systems, Second Me ensures that your information and intelligence remain local and completely private.

Getting started & staying tuned with us

Star and join us, and you will receive all release notifications from GitHub without any delay!

Quick Start

📊 Model Size vs. Memory (Reference Guide)

Note: "B" in the table represents "billion parameters model". Data shown are examples only; actual supported model sizes may vary depending on system optimization, deployment environment, and other hardware/software conditions.

Memory (GB) Docker Deployment (Windows/Linux) Docker Deployment (Mac) Integrated Setup (Windows/Linux) Integrated Setup (Mac)
8 ~0.8B (example) ~0.4B (example) ~1.0B (example) ~0.6B (example)
16 1.5B (example) 0.5B (example) ~2.0B (example) ~0.8B (example)
32 ~2.8B (example) ~1.2B (example) ~3.5B (example) ~1.5B (example)

Note: Models below 0.5B may not provide satisfactory performance for complex tasks. And we're continuously improving cross-platform support - please submit an issue for feedback or compatibility problems on different operating systems.

MLX Acceleration: Mac M-series users can use MLX to run larger models (CLI-only).

⚡ Get your Second Me running in just 3 steps:

# 1. Clone the repository
git clone https://github.com/mindverse/Second-Me.git
cd Second-Me
# 2. Start Docker containers
make docker-up
# 3. Access the web interface
# Open your browser and visit: http://localhost:3000

👉 For detailed instructions — including integrated (non-Docker) setup, model selection, memory requirements, and platform-specific tips, check the full Deployment Guide on GitBook.

❓ Got questions about setup, models, or any troubleshooting? Check our FAQ.

Tutorial and Use Cases

🛠️ Feel free to follow User tutorial to build your Second Me.

💡 Check out the links below to see how Second Me can be used in real-life scenarios:

What's Next: May 2025

Second Me continues to evolve as the open-source identity infrastructure for AI. Here's what's on deck for May:

Contributing

We’d love for you to help shape what’s coming next — whether it’s fixing bugs, building new features, or improving docs.

Contributors

We would like to express our gratitude to all the individuals who have contributed to Second Me! If you're interested in contributing to the future of intelligence uploading, whether through code, documentation, or ideas, please feel free to submit a pull request to our repository: Second-Me.

Made with contrib.rocks.

Acknowledgements

This work leverages the power of the open-source community.

For data synthesis, we utilized GraphRAG from Microsoft.

For model deployment, we utilized llama.cpp, which provides efficient inference capabilities.

Our base models primarily come from the Qwen2.5 series.

We also want to extend our sincere gratitude to all users who have experienced Second Me. We recognize that there is significant room for optimization throughout the entire pipeline, and we are fully committed to iterative improvements to ensure everyone can enjoy the best possible experience locally.

License

Second Me is open source software licensed under the Apache License 2.0. See the LICENSE file for more details.

Star History

Star History Chart

Second-Me (mindverse/Second-Me)

Searching Database…

15.7K ·GitHub
Second-Me
What is this?Second Me is an open-source project that lets you train a personal, locally-hosted AI model that preserves your identity, memory, and context, then connects it to a decentralized network so it can represent you across apps.
Is this an app I install, or infrastructure I run myself?It is self-hosted infrastructure: you deploy a local server (via Docker or an integrated setup) that trains and runs your own model, then optionally connects it to the Second Me network.
How do I get it running?You deploy it in 3 steps, either via Docker (Windows/Linux/Mac) or an Integrated (non-Docker) setup; full step-by-step instructions, model selection, and platform tips are in the Deployment Guide on GitBook.
What do I need before I start?You need Python and enough RAM for the model size you choose (the README's table ranges from 8GB for sub-1B models to 32GB+ for ~3B models); Mac M-series users can additionally use MLX for larger models, but that path is CLI-only.
Are there any catches before I rely on this?Models under 0.5B parameters may give unsatisfactory results on complex tasks, and cross-platform support is still being refined, so you may hit OS-specific issues.
Does it run on Windows and Linux, or just Mac?It runs on Windows, Linux, and Mac through either Docker deployment or an Integrated Setup, with memory requirements shown per platform in the Quick Start table.
What is 'AI Space'?AI Space lets multiple Second Me instances collaborate with each other to brainstorm ideas or solve problems together, acting as a meeting ground for different people's AI selves.
What does the Roleplay feature do?Roleplay lets your Second Me switch personas so it can represent you convincingly in different scenarios or conversations.
Why build this instead of just using a regular AI assistant?The authors see centralized 'Super AI' as a threat to individuality, so Second Me is designed to amplify one specific person rather than replace them, with training and hosting kept local and under the user's control.
What models power Second Me under the hood?Base models mainly come from the Qwen2.5 series, llama.cpp handles efficient local inference, and Microsoft's GraphRAG is used for data synthesis.
What are similar projects?unsloth, EnvoyMesh, runanywhere-sdks, Bonsai-demo, turnstone, rizzo-flow, khoj, petals
Which topics is it in?personal-ai, llamacpp, mlx, decentralized, privacy-first, qwen, memory, fine-tuning, local-llm, rag, offline, inference
Creator
mindverse
Size
347.3 MB
Stars
15.7K
Updated
CommitSep 19Releasev1.0.1May 13
Age
1y
Commits · 90 Days