Installation

There are two ways to install Ziva in your Godot project: automatic installation using our installer script, or manual installation like any other Godot plugin.

Automatic Installation (Recommended)

The automatic installer is a script that will guide you through the installation process and let you select which Godot project you want to install Ziva into.

Linux / macOS

Open your terminal and run:

curl -fsSL https://ziva.sh/install.sh | bash

Windows

Open PowerShell and run:

irm https://ziva.sh/install.ps1 | iex

The installer will:

• Download the latest version of Ziva
• Let you select which Godot project to install into
• Automatically set up the plugin in your project

Manual Installation

Alternatively, you can download and install Ziva manually like any other Godot plugin.

Step 1: Download the Plugin

Download the latest version from the download page or from GitHub releases .

Step 2: Open Your Godot Project Folder

The easiest way is to open your project in the Godot editor, then right-click the FileSystem panel and select “Open in File Manager”.

Step 3: Create an “addons” Folder

addons are where all Godot plugins live. If you don’t already have one, create it in your project root (next to your project.godot file).

Step 4: Extract and Copy the Plugin

Extract the downloaded zip file, and copy the addons/ziva-ai-agent folder to your project’s addons folder.

In the end, you should see addons/ziva-ai-agent in the Godot FileSystem.

Step 5: Restart Godot

Restart Godot completely to ensure the plugin loads properly.

Troubleshooting

If you don’t see the Ziva panel after following these steps:

• Try restarting Godot completely - Sometimes plugins need a full restart to load
• Check the Godot console for any error messages - Look in the Output tab for any red error messages
• Verify the folder structure - Make sure you have addons/ziva-ai-agent/ziva.gdextension in your project
• Check your Godot version - Ziva requires Godot 4.2 or later

Still having issues?

• Join our Discord for community support and help from other users
• Post an issue on GitHub  if you’ve found a bug or need technical assistance

System Requirements

• Godot Version: 4.2 or later
• Operating Systems: Windows, macOS, or Linux
• Internet Connection: Required for AI features

Next Steps

Once installed, you’re ready to start using Ziva!

Sign Up and Get Free Credits

When you create your Ziva account, you’ll receive 20 free credits to explore all features - no payment required. This gives you a great opportunity to try AI-powered game development before choosing a plan.

Visit ziva.sh  to sign up and start building!

For more information, check out the documentation to learn how to use the AI agent in your projects.