An open-source desktop AI companion with customizable characters, low-latency voice chat, Live2D avatars, and long-term memory.
Project-N-E-K-O/N.E.K.O
Open-source AI catgirl companion with real-time voice, proactive chat, five-part long-term memory, and agent tools for browser and computer tasks.
- Stars
- 3,087
- Forks
- 355
- Open issues
- 83
- Last commit
- 2 hours ago
What is it?
N.E.K.O. (Project N.E.K.O., the "catgirl project") is an AI companion platform that runs a persistent character on your desktop. It supports live voice conversation through the Realtime API and text chat through standard ChatCompletion endpoints, with real-time visual understanding of your screen. The character can start conversations on its own, sharing news, music, and media that match your interests.
The character keeps memory across sessions through a five-part system covering working, recent, factual, reflective, and persona memory. It appears as a Live2D, VRM, MMD, PNGTuber, or desktop-pet cat avatar, and can operate a browser or computer through agent tools. A plugin SDK and a Steam Workshop for sharing characters, models, and voice packs extend it further.
The core driver is licensed under Apache 2.0 and runs locally, and the project supports 14+ AI providers, including options with free models. It offers a one-click desktop build as well as Docker and source-based setups.
Key features
- 01Real-time voice conversation and text chat with visual understanding.
- 02Five-part memory system that keeps context across sessions.
- 03Proactive conversation starters based on screen content and trending topics.
- 04Live2D, VRM, MMD, PNGTuber, and desktop-pet avatar forms.
- 05Agent tools for operating a browser and computer and calling plugins.
- 06Plugin SDK and Steam Workshop for sharing characters and voice packs.
Use cases
- Keeping a desktop companion that chats while you work or play games.
- Experimenting with a self-hosted AI character that remembers past conversations.
- Building or sharing custom characters with their own avatars and voices.
- Letting an AI assistant handle browser or computer tasks while staying conversational.
Quick start
- 1
Download the one-click package for Windows, macOS or Linux and run N.E.K.O.exe, N.E.K.O.app or n.e.k.o
- 2
Or deploy with Docker Compose on Linux after creating the docker-compose.yml file from the README
docker-compose up -d
Things to know
- The Docker deployment is documented for Linux only.
- Running from source requires Python 3.11 specifically, plus uv and Node.js 20.19 or newer.
- The git history is about 390 MB, so a partial clone is recommended.
- Mobile iOS and Android versions are still in closed beta.
Topics
FAQ
- What is N.E.K.O?
- Open-source AI catgirl companion with real-time voice, proactive chat, five-part long-term memory, and agent tools for browser and computer tasks. N.E.K.O. (Project N.E.K.O., the "catgirl project") is an AI companion platform that runs a persistent character on your desktop. It supports live voice conversation through the Realtime API and text chat through standard ChatCompletion endpoints, with real-time visual understanding of your screen. The character can start conversations on its own, sharing news, music, and media that match your interests.
- Is N.E.K.O free to use? What license does it have?
- N.E.K.O is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
- Is N.E.K.O still maintained?
- Actively maintained. The last commit to N.E.K.O was on Oct 22, 2026.
- What can I use N.E.K.O for?
- Keeping a desktop companion that chats while you work or play games. Experimenting with a self-hosted AI character that remembers past conversations. Building or sharing custom characters with their own avatars and voices. Letting an AI assistant handle browser or computer tasks while staying conversational.
- How do I install N.E.K.O?
- Download the one-click package for Windows, macOS or Linux and run N.E.K.O.exe, N.E.K.O.app or n.e.k.o Or deploy with Docker Compose on Linux after creating the docker-compose.yml file from the README: docker-compose up -d
- Where can I get N.E.K.O?
- The source code and installation instructions are on GitHub: https://github.com/Project-N-E-K-O/N.E.K.O
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Self-hosted Telegram AI assistant that files your voice notes, photos and messages into a markdown memory vault it can search later.
Self-hosted, self-owned AI companion (VTuber-style virtual character) with realtime voice chat, game play, and Live2D/VRM avatars for Web, macOS and Windows.
A local-first AI companion daemon for Windows and macOS that keeps long-term memory of you, turns chats into office files, and can extend itself.
Open-source personal AI agent and voice assistant with a dual-brain design, personal memory, and delegation to coding agents.
A personal AI assistant that runs on macOS, Windows, iOS, Telegram, Slack and more, with persistent memory and proactive follow-ups.