Fennara Godot AI

English · 简体中文 · Español · Português do Brasil · 日本語 · 한국어 · Русский · Français · Deutsch · Türkçe

Used by Godot developers and teams, including Somni Game Studios.

Fennara gives AI assistants a live connection to Godot. Use it from MCP-capable apps like Codex, Claude, Cursor, Gemini, and Antigravity, or from the optional in-editor chat dock.

Agents can inspect scenes, check scripts, capture screenshots, read runtime errors, and validate changes inside the editor instead of guessing from project files alone.

What It Does

• exposes Godot-aware tools to external AI apps through MCP
• adds an optional local chat dock inside the Godot editor
• returns real Godot feedback: scene trees, diagnostics, screenshots, runtime logs, and validation results
• keeps the agent accountable to the open editor instead of only the filesystem

External MCP apps and the built-in chat use separate model settings. See MCP Apps And Built-In Chat and Built-In Chat Providers.

Requirements

• Godot 4.5 or newer.
• A supported desktop OS: Windows x86_64, Linux x86_64, or macOS arm64.
• An MCP-capable coding app only if you want to use Fennara from Claude, Codex, Cursor, Gemini, Antigravity, or another external AI app.
• A chat provider only if you want to use the built-in Fennara chat dock. This can be a cloud provider key or a local provider such as Ollama / LM Studio.

For the full install walkthrough, see Setup.

What Setup Adds

• the Fennara addon kept in res://addons/fennara/
• a small fennara CLI installed in Fennara app data
• a local MCP server used by AI coding apps
• a local daemon that bridges MCP/chat requests to the open Godot editor
• generated project guidance for AI agents

The built-in chat dock uses the platform webview: Microsoft Edge WebView2 on Windows, WKWebView/WebKit on macOS, and a Fennara-managed shared CEF runtime on Linux. MCP tools still work if the optional chat dock cannot start.

Install

On Windows and Linux, choose either the addon or CLI install. On macOS, use the CLI install below if you want to avoid the macOS security notification that can appear after manually downloading and extracting the addon ZIP.

Add The Addon To Your Project

• Open the Latest Release, download fennara-addon-latest.zip, and extract its addons/fennara/ folder into your project.

Open the project, select the Fennara dock, and press Set Up Fennara.

Fennara is an editor dependency, not a game runtime dependency. During export, the editor plugin removes its runtime autoload from the exported project and skips res://addons/fennara/ and res://.fennara/. The editor project is restored after the export finishes. If a CI checkout excludes the addon with .gitignore, run fennara prepare-export --project path/to/project before starting Godot, or install the addon in that checkout. Godot validates autoload paths before export plugins can run, so this preparation must happen first.

macOS: The release addon contains a native library that is not currently Apple-notarized. If you download the addon ZIP through a browser and extract it manually, macOS may report that it cannot verify libfennara.macos.editor is free of malware. To avoid this notification, use the CLI installation below. If you already see the notification, close Godot, remove the manually copied addons/fennara/ folder, then install Fennara with the CLI.

Install With The CLI (Recommended On macOS)

The CLI installs the same Fennara addon. It is the recommended installation method on macOS because it avoids the browser and Finder quarantine path that causes the notification described above.

Install the CLI on Windows:

irm https://raw.githubusercontent.com/fennaraOfficial/fennara-godot-ai/main/install.ps1 | iex

Or on macOS and Linux:

curl -fsSL https://raw.githubusercontent.com/fennaraOfficial/fennara-godot-ai/main/install.sh | sh

Then run Fennara from your Godot project:

cd path/to/your-godot-project
fennara install

See Setup for troubleshooting and Fennara CLI for the complete command reference.

Set Up A Provider Or Connect An MCP App

Built-In Chat

Open Chat Settings > Chat, select Open providers, and connect a provider. Fennara uses your own key for cloud providers (BYOK). You can also use a local Ollama or LM Studio server. See the supported provider list.

MCP Apps

Open Chat Settings > MCP Apps, find your app, and press Set Up.

You can also connect an app from the terminal:

fennara mcp-setup --codex
fennara mcp-setup --help

If your MCP app is not listed in Chat Settings, see MCP Setup for the complete app list and manual configuration instructions.

Update

When the Fennara dock shows Update, press it and follow the prompts.

Upgrading from Fennara v0.3.8 or older: Reinstall the CLI once with the platform install command above before running fennara update. Those CLI versions resolve a retired release tag and cannot discover current releases. Reinstalling the CLI switches future updates to GitHub's Latest Release endpoint and does not remove your existing project addon or settings.

macOS users upgrading from Fennara v0.3.11: Reinstall the CLI once with the macOS install command above before updating. The v0.3.11 CLI rejects the existing macOS framework bundle before it can self-update. Reinstalling only replaces the CLI; it does not remove your project addon or settings.

To update from the terminal, close Godot and run:

cd path/to/your-godot-project
fennara update

See Update Fennara for recovery and diagnostics.

Tools

Fennara exposes a small set of Godot-aware tools:

• write or update project files and return diagnostics
• run one-off scene edit scripts
• inspect scene trees, nodes, resources, and Godot classes
• validate scenes
• capture screenshots
• start runtime sessions and read runtime logs
• run small runtime scripts against a live scene

The goal is not to replace an agent's normal file tools. Fennara gives the missing Godot feedback loop.

Privacy

Fennara sends one anonymous active-installation event at most once per UTC day after Godot connects. It contains a random installation UUID, Fennara and Godot versions, operating system, and CPU architecture. It does not contain project data, paths, prompts, tool activity, logs, screenshots, or account information.

Telemetry can be disabled in Chat Settings > Chat > Anonymous telemetry, with FENNARA_DISABLE_TELEMETRY=true, or with DO_NOT_TRACK=1. See Anonymous Telemetry for the complete payload, storage, transport, and opt-out contract.

Demos

Watch a hands-on Fennara walkthrough:

More videos:

• I Gave Codex an AI Game Image and It Built This in Godot
• Fennara MCP Builds a Katamari-Style Godot Game
• This Godot Plugin Transforms AI Game Development Forever

See Demos for more videos from the Fennara channel.

Star History

Documentation

Community

Questions, setup help, and early feedback are welcome on Discord:

https://discord.com/invite/3fF4ft9PTk

License

See LICENSE.md.