Getting started

Get Honey installed and run your Genkit app locally or deploy it in a few steps.

📦 Installation

Install Honey with the one-line installer:

curl -sS https://honey.invertase.io/install | bash

• Verify: Run honey --version to confirm the install.

🚀 Usage

Run locally

Firstly, ensure that your Genkit application is setup, and you have exported your Genkit instance, e.g:

index.ts

import { genkit } from "genkit";
import { googleAI } from "@genkit-ai/google-genai";

// Export your Genkit instance:
export const ai = genkit({
  plugins: [
    googleAI(),
  ],
});

ai.defineFlow("hello", ...);

Then start Honey pointing to your Genkit app from the CLI using your entry file:

honey index.ts

This starts the Honey dev server, which you can access at http://localhost:8787.

Deploy

Once you’re ready to deploy, run the following command to deploy your Genkit app to Honey:

honey deploy index.ts

After deployment, you can manage runs and view observability in the Honey web interface (or your configured dashboard URL).

Other commands

• Use honey dev index.ts for a local dev server with hot reload when available.

For more options, run honey --help or honey deploy --help.