Configuration Files

GenAIScript supports local and global configuration files to allow reusing common configuration settings and secrets across multiple scripts.

File resolution

GenAIScript will scan for the following configuration files and merge their content into the final configuration.

• ~/genaiscript.config.yaml
• ~/genaiscript.config.json
• ./genaiscript.config.yaml
• ./genaiscript.config.json

File format

The configuration file format is the following:

import { ModelConfiguration } from "./host"

/**
 * Schema for a global configuration file
 */
export interface HostConfiguration {
    /**
     * Path to the .env file
     */
    envFile?: string

    /**
     * List of glob paths to scan for genai scripts
     */
    include?: string[]

    /**
     * Configures a list of known aliases. Overriden by environment variables and CLI arguments
     */
    modelAliases?: Record<string, string | ModelConfiguration>
}

envFile property

The final location of envFile will be used to load the secret in the environment variables.

include property

The include property allows you to provide glob paths to include more scripts. Combined with a global configuration file, this allows to share script for a number of projects.

genaiscript.config.yaml

include:
    - "globalpath/*.genai.mjs"