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 →