# EchoSoul

**Repository Path**: endme/echo-soul

## Basic Information

- **Project Name**: EchoSoul
- **Description**: EchoSoul 是一个基于大语言模型的智能陪伴系统，旨在为用户提供温暖、自然、无评判的对话体验。无论你是感到孤独、需要倾诉，还是只想找个有趣的 AI 聊聊天，EchoSoul 都会用心倾听，并给予真诚的回应。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-29
- **Last Updated**: 2026-06-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EchoSoul - 你的 AI 虚拟陪伴伙伴

EchoSoul 是一个基于大语言模型的智能陪伴系统，旨在为用户提供温暖、自然、无评判的对话体验。无论你是感到孤独、需要倾诉，还是只想找个有趣的 AI 聊聊天，EchoSoul 都会用心倾听，并给予真诚的回应。

## ✨ 特性
- 🧠 基于大语言模型，理解自然语言情感
- 🎨 可自定义性格、语气和陪伴风格
- 📝 支持对话记忆，提供连续、个性化的交流
- 💬 轻量部署，快速接入

## 🎮 游戏化系统
- 🌱 养成系统：通过对话积累亲密度，解锁新对话话题、记忆容量扩容、专属互动动作
- 📋 每日任务：“早安问候”、“分享一天”等轻量任务
- 🏆 成就系统：记录聊天字数、累计天数、共同经历里程碑等成就
- 🎨 角色皮肤/主题：解锁不同的UI主题和角色外观

## 📖 共创叙事系统
- 🎬 叙事起点推荐：系统智能推荐故事开篇，激发创作灵感
- 🌿 剧情分支选择：用户在关键节点选择走向，影响故事发展
- 🤖 AI 自适应生成：AI 实时续写，动态适配分支，确保叙事连贯
- 🎯 多结局见证：共同走向独特结局，每次体验都不同
- 📂 叙事存档与回放：保存完整故事，随时回顾精彩旅程
- 👥 多人叙事模式：邀请伙伴加入，共建共享奇妙故事世界


locust -f locustfile.py --host=http://127.0.0.1:8000

chroma run --host localhost --port 8000 --path ./chroma_data

celery -A app.celery_app worker --loglevel=info -P threads

uvicorn app.main:create_app --factory --host 127.0.0.1 --port 9000 --reload

uvicorn app.main:create_app --factory --host 127.0.0.1 --port 8000 --workers 2

# 使用清华源安装
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

# 使用阿里源安装
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/


New-Item -Path . -Name ".gitignore" -ItemType File -Value ".env`n"



# 整体架构图

┌─────────────────────────────────────────────────────────────────┐
│                         Client Layer                             │
│         Web App / Mobile App (FastAPI静态 + WebSocket)           │
└─────────────────────────────────────────────────────────────────┘
                                  │
                                  ▼
┌─────────────────────────────────────────────────────────────────┐
│                      API Gateway (FastAPI)                       │
│       用户认证 / 会话管理 / 请求路由 / WebSocket连接管理            │
└─────────────────────────────────────────────────────────────────┘
                                  │
                                  ▼
┌─────────────────────────────────────────────────────────────────┐
│                       LangGraph Agent Core                       │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────────────┐ │
│  │ Message  │→│ Emotion  │→│   RAG    │→│    Response Gen      │ │
│  │  Node    │ │  Node    │ │  Node    │ │       Node           │ │
│  └──────────┘ └──────────┘ └──────────┘ └──────────────────────┘ │
│                              │                                     │
│                     State Management (Redis)                      │
└─────────────────────────────────────────────────────────────────┘
          │                    │                    │
          ▼                    ▼                    ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────────────┐
│    PostgreSQL   │ │     Redis       │ │   Chroma向量数据库       │
│  用户/角色数据   │ │ 短期记忆/会话   │ │ 情感记忆向量库           │
│  叙事树存储     │ │   实时状态      │ │   语义检索              │
└─────────────────┘ └─────────────────┘ └─────────────────────────┘
                                  │
                                  ▼
┌─────────────────────────────────────────────────────────────────┐
│                      阿里百炼平台 LLM API                         │
│    qwen-max / qwen-plus     text-embedding-v1    语音识别        │
└─────────────────────────────────────────────────────────────────┘