wangxijie001/yoji

What it solves

Yoji is a desktop AI companion designed to move beyond simple chatbots by giving the AI the ability to operate your computer, manage files, and interact with the OS. It focuses on privacy by keeping all data local and aims to create a more human-like interaction through an integrated emotion system and a visual avatar.

How it works

• OS Interaction: It uses a permission-based system to manage files, execute shell commands and Python scripts, and perform web searches.
• MCP Integration: It implements the Model Context Protocol (MCP) to allow the AI to dynamically discover and load external tools (e.g., weather, train tickets) without needing a traditional plugin system.
• Sub-Agent Architecture: It features a local "Workshop" to create both synchronous (immediate result) and asynchronous (background task) sub-agents that the main agent can dispatch tasks to without blocking the conversation.
• Memory & Emotion: It employs a three-layer memory architecture (User Profile, Dialogue Snapshots, and Semantic Memory via sqlite-vec) and a hormone-based emotion engine that alters the AI's tone and visual expressions based on time, weather, and user interaction.
• Interface: Built with Electron and React, it includes a Live2D avatar with lip-syncing and interactive animations, as well as macOS-native voice wake-up and TTS.

Who it’s for

Users who want a highly customizable, privacy-focused AI assistant that can actually perform tasks on their local machine and those who enjoy virtual companion experiences with visual and emotional depth.

Highlights

• Local-First Privacy: All memory and configuration are stored locally on the user's machine.
• Computer Control: Ability to run scripts and manage files with a user-approval safety mechanism.
• Dynamic Tooling: Support for MCP allows for nearly infinite extensibility via industry-standard protocols.
• Emotional Intelligence: A hormone-simulated emotion system that affects the AI's personality and the Live2D avatar's expressions.
• Multi-platform Connectivity: Integration with WeChat (via iLink ClawBot) allows the AI to be accessed from a mobile phone.
• Document Processing: Native support for extracting text from PDF and Word documents.