Comienza a usar Genkit con Go (beta)

En esta guía, se muestra cómo comenzar a usar Genkit en una app de Go.

Si detectas problemas con las bibliotecas o con esta documentación, infórmalos en nuestro repositorio de GitHub.

Requisitos

  • Go 1.24 o una versión superior. Consulta Download and install en la documentación oficial de Go.

  • Node.js 20 o una versión posterior (para la IU y la CLI de Genkit). Consulta la siguiente sección para ver una breve guía sobre la instalación de Node.

Instala Genkit

  1. Si no tienes Node 20 o una versión más reciente en tu sistema, instálalo ahora.

    Recomendación: Las herramientas nvm y nvm-windows son una forma práctica de instalar versiones específicas de Node si aún no lo hiciste en tu sistema. Estas herramientas instalan Node por usuario, por lo que no es necesario realizar cambios en todo el sistema.

    Para instalar nvm:

    Linux, macOS, etcéteraWindows

    Ejecuta el siguiente comando:

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

    Descarga y ejecuta el instalador como se describe en la documentación de nvm-windows.

    Luego, para instalar Node y npm, abre una shell nueva y ejecuta el siguiente comando:

    nvm install 20

  2. Para instalar la CLI de Genkit, ejecuta el siguiente comando:

    npm i -g genkit-cli

    Este comando instala la CLI de Genkit en el directorio de instalación de Node para que pueda usarse fuera de un proyecto de Node.

Crea y explora un proyecto de muestra

  1. Crea un directorio de proyecto nuevo:

    mkdir genkit-intro && cd genkit-intro

  2. Inicializa el módulo Go y obtén el paquete de Genkit:

    go mod init example/genkit-intro
go get github.com/firebase/genkit/go

Configura la clave de API de tu modelo

En esta guía, te mostraremos cómo usar la API de Gemini, que ofrece una cuota generosa en el nivel sin costo y no requiere una tarjeta de crédito para comenzar. Para usar la API de Gemini, necesitarás una clave de API. Si aún no tienes una, créala en Google AI Studio.

Después de crear una clave de API, establece la variable de entorno GEMINI_API_KEY como tu clave con el siguiente comando:

export GEMINI_API_KEY=<your API key>

Realiza tu primera solicitud

Comienza a usar Genkit con solo algunas líneas de código.

package main

import (
    "context"
    "log"

    "github.com/firebase/genkit/go/ai"
    "github.com/firebase/genkit/go/genkit"
    "github.com/firebase/genkit/go/plugins/googlegenai"
)

func main() {
    ctx := context.Background()

    // Initialize a Genkit instance.
    g, err := genkit.Init(ctx,
        // Install the Google AI plugin which provides Gemini models.
        genkit.WithPlugins(&googlegenai.GoogleAI{}),
        // Set the default model to use for generate calls.
        genkit.WithDefaultModel("googleai/gemini-2.0-flash"),
    )
    if err != nil {
        log.Fatal(err)
    }

    // Generate a model response.
    resp, err := genkit.Generate(ctx, g, ai.WithPrompt("Hello, Gemini!"))
    if err != nil {
        log.Fatal(err)
    }

    log.Println(resp.Text())
}

Próximos pasos

Ahora que ya puedes hacer solicitudes de modelos con Genkit, aprende a usar más capacidades de Genkit para compilar tus apps y flujos de trabajo potenciados por IA. Para comenzar a usar las capacidades adicionales de Genkit, consulta las siguientes guías:

  • Herramientas para desarrolladores: Aprende a configurar y usar la CLI y la IU para desarrolladores de Genkit para probar y depurar de forma local tu app.
  • Generar contenido: Aprende a usar la API de generación unificada de Genkit para generar texto y datos estructurados de cualquier modelo compatible.
  • Creación de flujos: Aprende a usar las funciones especiales de Genkit, llamadas flujos, que proporcionan la capacidad de observabilidad de extremo a extremo para los flujos de trabajo y la depuración completa de las herramientas de Genkit.
  • Administrar instrucciones: Descubre cómo Genkit te ayuda a administrar tus instrucciones y configuración como código.