Locrow AI - Local Artificial Intelligence Library for Minecraft

Attention: This library is in early development stage and may not be supported on your device.

Latest Updates Version 0.2.1 (September 16, 2025)

Fixed an issue that required installation of Microsoft Visual C++ libraries for AI package installation.

To apply changes, you need to delete the corresponding version folder at: <modpack_instance_folder>/locrowai/<locrowai_python_version> and restart Minecraft to reinstall AI packages.

Errors in operation are possible.

Advantages of Local Artificial Intelligence

Locrow AI operates completely locally, making it absolutely free! No more dependency on expensive API services like OpenAI. Now, with a graphics processor, you can run complex AI models similar to ChatGPT, text-to-speech conversion systems, and voice converters, bringing your mods to life without financial costs for users.

Windows Security Notifications

In version 0.2.1, a Windows security system request for network access permission will appear. Preliminary tests show that choosing "Allow" or "Cancel" does not affect functionality.

Supported Systems

List of compatible platforms. Using the mod on unsupported systems may lead to critical errors. We are actively working on expanding the list of supported configurations.

• Computers running Windows with NVIDIA graphics cards
• Support for additional systems is planned in the near future

Operation on Unsupported Servers

Starting from version 0.2.0, client offloading function is available, allowing mod usage on any server provided there is an online player with a supported version. To activate this function, configure the server configuration file toml according to your configuration. Details can be found in the changelog for version 0.2.0.

Artificial Intelligence Capabilities

Currently available functions:

• Lightweight language model with chat capabilities similar to ChatGPT
• Natural text-to-speech conversion with a small selection of voices
• RVC (voice conversion) model for converting voices to villager voices
• Access to Java API
• Access to JSON API

Development Plans

Planned additions:

• Support for Linux systems with NVIDIA graphics cards
• Support for Windows and Linux systems with graphics cards from other manufacturers
• Support for systems without dedicated graphics processors
• Support for Mac systems
• Official documentation
• Official support for model and voice packs
• Migration of packaged models to separate packages
• Official support for custom code injections into the AI environment

Frequently Asked Questions

When will support for my system be available?

Priority is given to the most common systems. If your configuration is not yet supported, contact the developer to increase priority.

What to do if my system is not supported but I want to use a mod that depends on this library?

This mod works only on the server side, so if you are not hosting the Minecraft world/server, you can safely disable this mod until support for your system is available.

How to use this library in my mod?

Currently, documentation is not available, but below is an example of usage from the Villager AI mod:

ScriptBuilder scriptBuilder = new ScriptBuilder();

scriptBuilder.then(new FunctionBuilder("/llm/chat")
    .feed("temperature", 0.7)
    .feed("messages", List.of(Map.of("role", "user", "content", "How are you?")))
    .feedReturn("content", "text")
    .passReturn("content", "script"))
.then(new FunctionBuilder("/tts")
    .feed("voice", "am_puck")
    .feed("speed", 1.1)
    .feedReturn("audio", "audio")
    .pass("script"))
.then(new FunctionBuilder("/rvc/infer")
    .feed("model", "villager")
    .feedReturn("audio", "audio")
    .feedReturn("samplerate", "original_sr")
    .pass("script"))
.then(new FunctionBuilder("/audio/resample")
    .feed("target_sr", 48000)
    .feedReturn("audio", "audio")
    .pass("script"))
.then(new FunctionBuilder("/audio/pcm_convert")
    .feedReturn("audio", "bytes")
    .pass("script"))
.then(new FunctionBuilder("/json_serializer/bytes"))
.returns("base64")
.returns("script");

Script script = scriptBuilder.build();
System.out.println(script.getJsonBlueprint());

script.execute(results -> {
    System.out.println(results.get("script").getAsString());
});

Known Issues

• Python environment does not close correctly when Minecraft server is improperly terminated.