This repository contains the API documentation for allowing Neuro-sama to play games.
There are also official SDKs available for Unity and Godot, as well as community-maintained SDKs. If you would like to use the Neuro API in a different engine or programming language, you will have to implement the websocket protocol yourself. If you do so, consider opening a pull request to this repository to share your implementation with others by adding a link to the README.
Significant API and SDK changes will be documented in the CHANGELOG.md file.
Last update: 17th of December 2025, 15:00 GMT
Please familiarize yourself with the API documentation before using the SDKs.
SDKs created and maintained by Alex, which are located in this repository. Pull requests are welcome.
- Randy is a simple bot that mimics the Neuro API. It makes random actions and can be used to test your integration.
Caution
These links are provided solely for convenience so that community members can find other implementations more easily.
We do not review, verify, or endorse any of the projects listed below, and they may change or stop working at any time.
Use any community-maintained SDKs, tools, or code at your own risk. We do not take any responsibility for their functionality, security, or reliability.
I understand. Click to expand and view list.
Third-party SDKs created and maintained by the community.
- Rust SDK
- JavaScript/TypeScript SDK
- Java SDK
- Lua SDK
- Gamemaker SDK
- C SDK
- Python SDK
- Kotlin SDK
- C++ SDK
- Generic C# SDK
- Ren'Py SDK
- Tony is a graphical testing interface, similar to Randy, but it allows the user to write messages manually.
- Jippity is a testing tool that aims to be a more "realistic" version of Randy, by using OpenAI to mimic Neuro.
- Gary is another backend implementation for advanced use. Originally created for testing with local LLMs like Llama, now also has support for a Randy-like "random generator" mode and a web UI for Tony-like manual sending.
The official SDKs have been created and optimized for turn-based games, namely Inscryption, Liar's Bar and Buckshot Roulette.
Games that require a non-low APM will generally not work well without Neuro only controlling the high-level actions and letting another system decide how to handle the low-level actions.
Since you need to describe the entire game state in text, and receive actions in text, only games where that is feasible will work well with this API.
Examples
Games that could work well
- Inscryption
- Liar's Bar
- Buckshot Roulette
- Keep Talking and Nobody Explodes
- Uno
- Monopoly
- Most visual novels
- Most card games
Games that would probably not work well
- Skyrim (solo)
- League of Legends
- Celeste
- Euro Truck Sim
- CSGO
- Any real-time strategy game
- Shooters
- Platformers