Project N.E.K.O.Developer Documentation

Build the living AI companion metaverse — open source, extensible, multi-modal.

Microservice Architecture

Three-server design (Main, Memory, Agent) with WebSocket real-time communication, ZeroMQ event bus, and hot-swappable LLM sessions.

Learn more

🔌

Plugin SDK

Extend N.E.K.O. with Python plugins. Decorator-based API, async support, lifecycle hooks, and persistent state management.

Build a plugin

🌐

REST & WebSocket API

Comprehensive API surface — 10 REST routers covering characters, models, memory, agents, and a streaming WebSocket protocol for real-time voice/text chat.

API reference

🧠

Memory System

Semantic recall via embeddings, time-indexed history, compressed recent memory with sliding window, and persistent user preferences.

How it works

🤖

Agent Framework

Background task execution via MCP, Computer Use, and Browser Use adapters. Automatic task planning, deduplication, and parallel capability assessment.

Explore agents

🎨

Live2D & VRM

Rich frontend with Live2D and VRM model rendering, emotion mapping, voice cloning, and internationalization across 5 languages.

Frontend guide