Wiki / Guides / Instalacion

Instalacion

Guia completa para instalar OhMyDialogSystem en tu proyecto Godot.

Requisitos

🎮

Godot 4.5 o superior

El addon usa GDExtension con compatibilidad minima 4.5.

💾

8GB+ RAM recomendado

Los modelos LLM consumen memoria significativa. Modelos pequenos (~2GB) funcionan con menos.

🖥

GPU opcional

llama.cpp puede usar CPU. GPU acelera la generacion pero no es obligatorio.

💻 Plataformas Soportadas

🪟 Windows x86_64 🐧 Linux x86_64 🍎 macOS (Universal)

📦 Instalacion

1

Descargar el Addon

Descarga la ultima version desde GitHub Releases.

GitHub Releases →
2

Copiar al Proyecto

Extrae el archivo y copia la carpeta addons/ohmydialog a tu proyecto.

tu_proyecto/
└─ addons/
   └─ ohmydialog/ ← Copiar aqui
3

Activar el Plugin

Ve a Project -> Project Settings -> Plugins y activa "OhMyDialogSystem".

4

Reiniciar Editor

Godot pedira reiniciar. Acepta para cargar el GDExtension.

Verificar Instalacion

Boton AI en el Toolbar

Deberia aparecer un boton "AI" en la barra de herramientas del editor.

AutoLoad Registrado

AIServiceAutoload deberia aparecer en Project Settings -> AutoLoad.

Mensaje en Consola

Busca "OhMyDialogSystem: Plugin loaded" en la consola de Godot.

🔄

Registro Automatico

El plugin registra automaticamente el AutoLoad "AIServiceAutoload" al activarse. No necesitas configurarlo manualmente.

Si desactivas el plugin, el AutoLoad permanece registrado. Puedes eliminarlo manualmente en Project Settings -> AutoLoad si lo deseas.

📂 Estructura del Addon

addons/ohmydialog/
ai/ APIs de HuggingFace, descarga de modelos, parseo GGUF
autoload/ Singleton AIServiceAutoload para runtime
core/ AIService, DialogueManager, ContextManager, ejecutores
editor/ DialogueGraphEditor, inspectors personalizados, ventanas
resources/ CharacterIdentity, DialogueGraph, ModelConfig, AIPreset
gdextension/ Binarios nativos de llama.cpp por plataforma

Siguientes Pasos

Sigue la guia Quick Start para descargar un modelo y probar tu primera conversacion con IA.

Quick Start →