English · 简体中文 · 日本語 · Русский
Project N.E.K.O.
Open-source companion agents, and a community where humans and nekos live together.
N.E.K.O. = Networked Emotional Knowledging Organism
This README is for developers. If you just want to use N.E.K.O., get it free on Steam or visit project-neko.cn.
What it is
Personal agents such as OpenClaw showed that people want an AI of their own: one that runs on their machine, remembers them, acts for them, and grows closer the longer they spend together. N.E.K.O. brings that idea into companionship in the broadest sense. Your companion talks with you in realtime voice, sees your screen, remembers the days you have shared, plays games with you and takes part in your social life. Under the hood is a local runtime, open-sourced under Apache 2.0, that integrates realtime voice and vision, a biomimetic long-term memory, embodied avatars, proactive behavior, agent tools and a plugin SDK. Around it, a warm community is taking shape: users write plugins, forge and share story cards, and send their companions to visit one another.
Highlights
🎮 Plays games with you
- Built-in two-player games: air basketball, badminton, drawing guess, soccer, and watch-together. A mini-game SDK and a game-vision service let developers add more.
- Plays alongside you: in Overcooked! 2, Slay the Spire 2 and Minecraft she is your player 2 and plays the game with you. In War Thunder, Strinova, World of Warships and KARDS she is your copilot: community plugins read the game's telemetry or screen so she can give live callouts and commentary, and she never cheats. Any auto-play is opt-in. The bundled Minecraft plugin connects to a separately started local Minecraft agent server (setup).
- Takes the controls: when you ask, plugins let her play by herself in Plants vs. Zombies, Titanfall 2, Half-Life & Portal and Subnautica; you can take over at any time.
- Knows your game: companions for Genshin Impact, Honkai: Star Rail, Civilization VI and RimWorld read the game state so she can chat about your run and give advice.
- Screen awareness: she can watch whatever you are playing and chime in.
🐾 Has a social life
- Visits: two users' companions meet in a shared room, talk, and each brings the memory home.
- Nekoverse, the companion community:
- story cards forged in the app from your companion's memories of your days together, then collected, nurtured and shared;
- a feed curated by YUI, weekly picks of hidden gems, creator rankings, and a points store.
- Group-aware memory: the companion can keep separate memories per person and per group. Visits use this today, and group-chat plugins can build on it.
🔌 A plugin market that is already busy
market.project-neko.cn had 100+ plugins, 10K+ downloads and 50+ active developers as of October 2026. A few community favorites:
| Plugin | What it adds |
|---|
| War Thunder Catgirl Copilot | Reads the game's local telemetry and turns it into battle callouts and commentary |
| Slay the Spire 2 Companion | Overlays her live commentary on the game as scrolling comments, rates each turn's risk and suggests plays; auto-play is optional |
| PVZ Agent | She plays Plants vs. Zombies herself: watches the board, says her plan out loud and makes the moves, and you can steer her |
| Strinova Companion | Plays Strinova alongside you with voice callouts, starting and stopping with the game |
| Live Streaming Assistant | Handles live comments, viewer profiles and commentary on streaming platforms |
| Catgirl Diary | She keeps a daily diary of small moments and moods |
Any developer can publish with the plugin SDK and the neko-plugin CLI.
📱 One companion across phone, desktop and devices
- Today:
- chat and long-term memory sync between devices (opt-in);
- Steam Cloud saves;
- the mobile app is in closed beta.
- Planned: companion smart hardware, including but not limited to mirrors, plush dolls, drones and robots. The goal is for the same companion and memory to carry over to each device.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
