Quick Start
En 5 minutos tendras tu primera conversacion con IA funcionando en Godot.
Paso 1: Abrir el Model Manager
En el toolbar de Godot, haz click en el boton "AI" y selecciona "AI Models".
El boton AI aparece despues de activar el plugin y reiniciar el editor.
Paso 2: Buscar un Modelo
Haz click en "Browse HuggingFace" para explorar modelos disponibles.
Recomendamos empezar con modelos pequenos (1-2GB) como Qwen2.5-1.5B o Phi-3-mini.
Busca por nombre o filtra por tamaño. Los modelos Q4_K_M ofrecen buen balance calidad/tamaño.
Paso 3: Descargar el Modelo
Selecciona el modelo en la lista y haz click en "Download Model".
user://models/ por defecto.
Paso 4: Cargar el Modelo
Una vez descargado, el estado cambia a "Ready". Haz click en "Load Model".
Paso 5: Probar Generacion
Ve a la pestaña "Generation" para probar el modelo.
La respuesta aparece en tiempo real (streaming) en el panel de salida.
💻 Uso desde Codigo
Tambien puedes usar AIService directamente desde GDScript.
# Obtener el servicio de IA
var ai_service = AIService.get_singleton()
# Verificar si hay modelo cargado
if ai_service.is_model_loaded():
# Obtener la interfaz LLM
var llama = ai_service.get_llama()
# Configurar parametros
llama.set_temperature(0.7)
llama.set_max_tokens(256)
# Generar respuesta
var prompt = "You are a helpful assistant.\n\nUser: Hello!\nAssistant:"
var response = llama.generate(prompt)
print(response)
else:
push_warning("No hay modelo cargado")🦙 Modelos Recomendados para Empezar
Pequeno (~1GB)
Rapido, bajo consumo de RAM. Ideal para pruebas.
Mediano (~2-4GB)
Mejor calidad de respuestas. Balance rendimiento/calidad.
Grande (~7GB+)
Maxima calidad. Requiere GPU recomendada.