Skip to content

🌸 YuanBotNot a tool, but a companion

An open-source AI virtual companion with memory, emotions, and proactive care

🚧 English documentation is a work in progress.
Full English translation is coming soon. For now, please refer to the Chinese documentation.

Quick Install

pip

bash
# 源码安装(见 Installation 页面)
git clone https://github.com/Grabrun/YuanBot.git
cd YuanBot
python -m venv .venv
.venv\Scripts\activate
pip install -e ".[dev]"
yuanbot start

Docker

bash
git clone https://github.com/Grabrun/YuanBot.git
cd YuanBot
cp .env.example .env
docker-compose up -d

© 2026 YuanBot · Made with 🌸 by Grabrun

Made with 🌸 by Grabrun