ex-skill  by therealXiaomanChu

AI Skill for simulating past relationships

Created 1 week ago

New!

4,202 stars

Top 11.5% on SourcePulse

GitHubView on GitHub
Project Summary

Summary ex-skill enables users to create an AI persona of a past partner using personal data like chat logs and photos. It serves as a tool for emotional healing and memory recall, allowing interaction with an AI mimicking an ex's communication style and personality.

How It Works The system uses a dual-component architecture: Relationship Memory and Persona. Memory archives shared experiences and timelines. Persona, structured across five layers (hard rules, identity, speaking style, emotional patterns, relational behavior), defines communication nuances. Data ingestion from chat logs, social media, photos, and descriptions builds these components, facilitating AI responses that mirror the ex's mannerisms and recall shared history.

Quick Start & Requirements Installation involves cloning the repository into the Claude Code environment's .claude/skills/ directory. A typical command is git clone https://github.com/therealXiaomanChu/ex-partner-skill .claude/skills/create-ex. Optional dependencies are managed via pip3 install -r requirements.txt. Users require external tools (e.g., WeChatMsg, PyWxDump) to export chat logs for accurate skill generation.

Highlighted Details

  • Supports diverse data inputs: WeChat/QQ chat logs, social media screenshots, photos (EXIF), and user-provided text.
  • Features a 5-layer persona model capturing nuanced personality and behavioral aspects.
  • Integrates psychological frameworks: attachment styles, love languages, MBTI, and zodiac signs.
  • Includes an evolution mechanism for memory addition, real-time dialogue correction, and version management with rollback.

Maintenance & Community Adhering to the AgentSkills open standard, the project is compatible with Claude Code and OpenClaw. It is inspired by colleague-skill. Specifics on active maintenance, core contributors, or community channels are not detailed in the README.

Licensing & Compatibility Released under the permissive MIT License, this project offers broad compatibility, including commercial use and integration into closed-source applications without significant restrictions.

Limitations & Caveats AI skill fidelity heavily depends on input data quality; chat logs are recommended. The project is strictly for personal memory and emotional healing, warning against misuse for harassment or privacy violations. The AI represents a memory construct, not the actual individual. It advises seeking professional help for unhealthy obsessions.

Health Check
Last Commit

3 days ago

Responsiveness

Inactive

Pull Requests (30d)
4
Issues (30d)
65
Star History
4,270 stars in the last 11 days

Explore Similar Projects

Feedback? Help us improve.