Skip to content

sancheznot/Godot-AI-Assistant

BranchesTags

Repository files navigation

                           (((((((             (((((((
                        (((((((((((           (((((((((((
                        (((((((((((((       (((((((((((((
                        (((((((((((((((((((((((((((((((((
                        (((((((((((((((((((((((((((((((((
         (((((      (((((((((((((((((((((((((((((((((((((((((      (((((
       (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
     ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
    ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
      (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
        (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         (((((((((((@@@@@@@(((((((((((((((((((((((((((@@@@@@@(((((((((((
         (((((((((@@@@,,,,,@@@(((((((((((((((((((((@@@,,,,,@@@@(((((((((
         ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((
         ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((
         (((((((((@@@,,,,,,,@@((((((((@@@@@((((((((@@,,,,,,,@@@(((((((((
         ((((((((((((@@@@@@(((((((((((@@@@@(((((((((((@@@@@@((((((((((((
         (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         @@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@
         ((((((((( @@@(((((((((((@@(((((((((((@@(((((((((((@@@ (((((((((
         (((((((((( @@((((((((((@@@(((((((((((@@@((((((((((@@ ((((((((((
          (((((((((((@@@@@@@@@@@@@@(((((((((((@@@@@@@@@@@@@@(((((((((((
           (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
              (((((((((((((((((((((((((((((((((((((((((((((((((((((
                 (((((((((((((((((((((((((((((((((((((((((((((((
                        (((((((((((((((((((((((((((((((((

   ______      __                     ___    ____
  / ____/___  / /__  ____ ___        /   |  /  _/
 / / __/ __ \/ / _ \/ __ `__ \______/ /| |  / /  
/ /_/ / /_/ / /  __/ / / / / /_____/ ___ |_/ /   
\____/\____/_/\___/_/ /_/ /_/     /_/  |_/___/

Golem-AI — el golem de Godot con inteligencia artificial.

Golem-AI

Golem-AI logo

AI-powered editor assistant for Godot 4 — chat with local or cloud models, edit scenes, run editor tools, attach files and images, and manage agent sessions from the dock.

Created by sancheznotdev · MIT License

Screenshots

Editor dock — chat, model/skills toolbar, context/agent toggles, and vision/thinking options.

Golem-AI dock in the Godot editor

Agent history & @ context — searchable sessions, multi-select, pin/archive, and autocomplete for scenes, files, and skills.

Golem-AI history panel and @ mention autocomplete

Models & providers — one dropdown with local and cloud models grouped by provider (Ollama, LM Studio, MiniMax, Cursor, OpenRouter, Kimi, OpenAI, Anthropic, Gemini).

Golem-AI model selector with Ollama, LM Studio, MiniMax and Cursor providers

Features

Chat & composer

  • Bubble UI with collapsible thinking blocks, tool calls, tool results, and code blocks
  • Copy button on assistant messages and collapsible code blocks
  • Attachments: text files (.gd, .tscn, .md, …) and images (PNG, JPG, WebP, …)
  • @ mentions and / commands with autocomplete
  • Vision and Think toggles — auto-enabled only when the selected model supports them (preferences persist between sessions)

Providers & models

Provider Notes
Ollama Local models
LM Studio Local server; reads capabilities.vision from native API
OpenRouter Many cloud models, pay-as-you-go
Kimi Moonshot AI
MiniMax M3 = visión + thinking; M2.x = solo texto + thinking (sin imágenes)
OpenAI Cloud API
Anthropic Cloud API
Gemini Google API
Cursor Local OpenAI-compatible proxy or cloud agents
  • Model dropdown grouped by provider separators
  • ↻ Refresh loads models from each enabled provider
  • Capability detection (model_capabilities.gd) + provider metadata (LM Studio / OpenRouter) to avoid invalid vision/thinking options

MiniMax models (official API)

Source: MiniMax models · Anthropic-compatible API

Model Vision (images) Thinking
MiniMax-M3 Yes (image + video) Yes (toggle disabled / adaptive)
MiniMax-M2.7 / highspeed No Yes (always on at API)
MiniMax-M2.5 / highspeed No Yes (always on at API)
MiniMax-M2.1 / highspeed No Yes (always on at API)
MiniMax-M2 No Yes (always on at API)
M2-her No No (dialogue / roleplay)

Only MiniMax-M3 accepts image_url / video_url in chat. All other MiniMax chat models are text + tools only.

Agent & tools

  • Editor tools — optional tool-calling loop in the Godot editor
  • Agent loop — multi-step verify & fix with compact tool results (faster, less redundant inspection)
  • Skills system — Markdown skills (/skill, dropdown, @skill:id)
  • Project context — open scene, selection, @file mentions, configurable depth

Session history

  • Search, pin, archive, and New Agent (Ctrl+N; Alt replaces current session)
  • Multi-select — checkboxes per chat, Select all, bulk Archive / Restore / Delete
  • Delete confirmation — single chat or bulk; clears selection after archive/restore/delete
  • More menu (⋮): clear messages, delete active chat, open config

Localization

  • English / Spanish UI (Config → UI language: auto, en, es)

Requirements

  • Godot 4.2+ (tested on 4.6.x)
  • At least one AI provider configured (e.g. Ollama or LM Studio for local use)

Installation

Manual

  1. Copy this folder into your project:

    your_project/addons/ai_assistant_plugin/

  2. Open Project → Project Settings → Plugins

  3. Enable AI Assistant Plugin

  4. Open the AI Assistant dock tab in the editor

From GitHub

git clone https://github.com/sancheznot/Godot-AI-Assistant.git addons/ai_assistant_plugin

Then enable the plugin in Project Settings.

Git safety (plugin vs game project)

If you develop inside a larger Godot game, keep two separate git repos:

Repo Folder Remote
Golem-AI plugin addons/ai_assistant_plugin/ Godot-AI-Assistant
Your game project root your game remote

In the game .gitignore, ignore the plugin folder so nested git does not mix:

addons/ai_assistant_plugin/

After git clone or git init in this folder, install the guard hook:

cd addons/ai_assistant_plugin
./install_git_hooks.sh
./scripts/verify_git_repo.sh

The pre-commit hook blocks commits if plugin.cfg is missing, origin is wrong, or game paths (Maps/, Data/, …) are staged.

Quick start

  1. Click Config in the dock toolbar
  2. Enable a provider (e.g. Ollama or LM Studio) and set endpoint + model
  3. Click ↻ to refresh the model list
  4. Choose Context, Tools, Agent, Think, and Vision as needed (greyed-out toggles = model does not support that feature)
  5. Type a message and press Enter

Attachments

Control Action
📎 Attach a text file (content injected into context)
🖼 Attach an image (requires Vision on + vision-capable model)

You can send attachments without text; the plugin uses a default analysis prompt.

Composer shortcuts

Input Action
@ Attach context (scene, files, skills)
/ Commands (/help, /clear, /history, /skill, …)
Enter Send message
Shift+Enter New line
Ctrl+N New agent (session)
Alt+click + Replace current agent (clear messages)

History panel

Control Action
Checkbox on row Select chat for bulk actions
All Select / deselect visible chats
Archive / Restore Bulk archive or unarchive selection
Delete Bulk delete with confirmation
⋯ / 🗑 Per-chat menu or delete

Configuration

Copy the example config on first setup:

cp addons/ai_assistant_plugin/config/plugin_config.example.json \
   addons/ai_assistant_plugin/config/plugin_config.json

Settings (endpoints, models, toggles) are stored in config/plugin_config.json. API keys are never written there.

API keys & secrets

Storage Path / variable Notes
Encrypted file user://ai_assistant_plugin/secrets.enc Default. Keys from the Config UI are saved here via Godot's encrypted file API.
Passphrase GOLEM_AI_SECRETS_PASSPHRASE Optional. Custom passphrase for secrets.enc. Default: machine id (per device).
Environment GOLEM_AI_API_KEY_<PROVIDER> Optional override per provider, e.g. GOLEM_AI_API_KEY_OPENAI, GOLEM_AI_API_KEY_MINIMAX. Takes priority over the encrypted store.

On first launch after updating, keys still present in an old plugin_config.json are migrated automatically to secrets.enc and removed from the JSON.

Do not commit API keys. plugin_config.json is gitignored; use plugin_config.example.json as the template. If keys were ever pushed to git, rotate them in each provider's dashboard.

Key options in plugin_config.json:

  • Providers — endpoints, API keys, default models
  • Context depth — basic / intermediate / full
  • Agent loop — multi-step verify & fix with editor tools
  • enable_vision / enable_thinking — persisted preferences (respect model capabilities)
  • Skills path — folder with .md skill files
  • UI language — auto, en, es

Chat history is saved under user://ai_assistant_plugin/chat_history.json.

Project structure

ai_assistant_plugin/
├── icon.png
├── docs/                      # AssetLib previews
│   ├── preview_dock.jpg
│   ├── preview_autocomplete.jpg
│   └── preview_models.jpg
├── plugin.cfg
├── config/
├── harness/                   # System prompt layers
├── locales/                   # en.json, es.json
├── scenes/                    # Dock UI
├── scripts/
│   ├── ui_plugin.gd           # Chat UI, history, attachments
│   ├── ai_model_handler.gd    # Providers, multimodal, agent loop
│   ├── model_capabilities.gd  # Vision/thinking heuristics
│   ├── composer_attachments.gd
│   ├── model_catalog.gd
│   ├── chat_history.gd
│   └── …
└── skills/                    # Built-in skills (.md)

Contributing

Issues and PRs welcome on GitHub. Please keep changes focused and match existing code style.

License

MIT — see LICENSE.

Copyright (c) 2026 sancheznotdev

Author

sancheznotdev
GitHub: @sancheznot

If you use this plugin in a project or video, a mention or link is appreciated — not required by the license.

Español

Golem-AI — asistente de IA integrado en el editor de Godot 4.

Autor: sancheznotdev · Licencia MIT

Novedades recientes

  • Adjuntos: archivos de texto e imágenes en el compositor (📎 / 🖼)
  • Visión y Think: toggles inteligentes según capacidades del modelo (Gemma, Qwen 3.6, Composer, LM Studio, etc.)
  • Proveedores: OpenRouter, Kimi, MiniMax (visión solo en MiniMax-M3)
  • Historial: selección múltiple, archivar/restaurar/eliminar en lote, confirmación al borrar
  • UI: bloques colapsables (thinking, tools, código) con botón copiar; modelos agrupados por proveedor
  • Agente: respuestas más rápidas, menos inspección redundante, resultados de tools compactos

Instalación: copia la carpeta a addons/ai_assistant_plugin, activa el plugin en Ajustes del proyecto y configura un proveedor desde Config en el dock.

Capturas: ver sección Screenshots arriba (dock, historial con @, selector de modelos).

About

Golem-AI is an AI-powered editor assistant for Godot 4. Chat with local or cloud models (Ollama, LM Studio, OpenAI, Anthropic, Gemini, Cursor) directly from an editor dock.

Topics

godot-engine godot4

Resources

Readme

License

MIT license
Activity

Stars

5 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages