Genkit Best Practices

Project Structure

• Organized Layout: Keep flows and tools in separate directories (e.g., src/flows, src/tools) to maintain a clean codebase.
• Index Exports: Use index.ts files to export flows and tools, making it easier to import them into your main configuration.

Model Selection (Google AI)

• Gemini Models: If using Google AI, ALWAYS use the latest alias (gemini-flash-latest or gemini-pro-latest).
  • Recommended: gemini-flash-latest for general use, gemini-pro-latest for complex tasks.

Model Selection (Other Providers)

• Consult Documentation: For other providers (OpenAI, Anthropic, etc.), refer to the provider's official documentation for the latest recommended model versions.

Schema Definition

• Use z from genkit: Always import z from the genkit package to ensure compatibility.

  import { z } from "genkit";
  

• Descriptive Schemas: Use .describe() on Zod fields. LLMs use these descriptions to understand how to populate the fields.

Flow & Tool Design

• Modularize: Keep flows and tools in separate files/modules and import them into your main Genkit configuration.
• Single Responsibility: Tools should do one thing well. Complex logic should be broken down.

Configuration

• Environment Variables: Store sensitive keys (like API keys) in environment variables or .env files. Do not hardcode them.

Development

• Use Dev Mode: Run your app with genkit start -- <start cmd> to enable the Developer UI.
• It is recommended to configure a watcher to auto-reload your app (e.g. node --watch or tsx --watch)