Overview
ECHO_loop is a technical path for the Minecraft AI companion project, implementing the React Agent Loop engineering approach. The architecture combines LLM orchestration, Mineflayer game interaction, and local memory storage to create an AI that acts as an independent player character in the game.
Platform Support: Windows 10/11 x64 only.
Technical Architecture
┌─────────────────────────────────────────────────────────────┐
│ Electron Desktop App │
├─────────────────────────────────────────────────────────────┤
│ Vue 3 Frontend (Chat UI / Memory Panel / Settings) │
├─────────────────────────────────────────────────────────────┤
│ IPC Communication Layer │
├─────────────────────────────────────────────────────────────┤
│ Node.js Main Process │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ LangChain Agent (Tool-Calling) │ │
│ └─────────────────────────────────────────────────────┘ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ Mineflayer Bot Controller │ │
│ └─────────────────────────────────────────────────────┘ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ Local Vector Database (sql.js) │ │
│ └─────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
Comparison with Other ECHO Paths
| Project | Implementation Approach |
|---|---|
| ECHO_feeling | Intrinsic emergence (7-layer cognition, PAD/OCC emotion, BDI intention) |
| ECHO_loop | React Agent Loop engineering (this project) |
| ECHO_CLAW | Context + Skill invocation, similar to Claude Code CLI |
Core Workflow
Player Input → Mineflayer Listener → LangChain Agent
→ Generate JavaScript Code Blocks → Local Sandbox Batch Execution
→ Store Memory → Reply to Player
Development Scripts
| Command | Description |
|---|---|
npm run dev | Development mode |
npm run build | Compile to out/ |
npm run typecheck | TypeScript check |
npm test | Unit tests |
npm run e2e | Lightweight smoke tests |
npm run pack | Generate Windows installer |
Current Status
Design stage, architecture planning in progress.