Overview

Puzzlet provides extensive configuration options that give application developers full control over model selection, configuration, and behavior. All configuration is managed through the puzzlet.json file in your project root.

These options allow you to customize your Puzzlet dashboard to your needs.

​

Initializing the puzzlet.json file

You can initialize the puzzlet.json file by running the following command:

npx @puzzlet/cli@latest init

​

The puzzlet.json File

The puzzlet.json file is the central configuration file for your Puzzlet implementation. It consists of two main components:

{
  "puzzletPath": "/",
  "modelSchemas": {
    // Model configurations go here
  }
}

​

puzzletPath

The puzzletPath property defines the base directory where Puzzlet will look for your application’s resources including:

• Prompt templates
• Evaluation configurations
• Datasets
• Other Puzzlet-specific resources

By default, this is set to ”/”, meaning Puzzlet will look in your project root. You can modify this path if you want to organize these resources in a different directory structure.

​

modelSchemas

The modelSchemas object is where you define all available models for your application. Each model entry contains:

• A unique identifier (e.g., “gpt-4”, “claude-3-5-sonnet-latest”)
• Display configuration (labels, descriptions)
• Model-specific settings and their UI controls
• Parameter constraints and defaults