SDK Prompt Quickstart

​

How to get started with the Maxim SDK?

​

Installation

pip install maxim-py

npm install @maximai/maxim-js

​

Getting Your API Key

1. Log in to Maxim: Go to app.getmaxim.ai/login and sign in to your account
2. Navigate to Settings: Click on “Settings” in the left sidebar
3. Go to API Keys: Click on “API keys” under “Organization settings”
4. Generate New Key: Click the “Generate new” button
5. Name Your Key: Enter a descriptive name for your API key (e.g., “Development”, “CI/CD”, “Local Testing”)
6. Copy the Key: Once generated, copy the API key immediately - you won’t be able to see it again

​

Configuration

from maxim import Maxim

# Initialize Maxim SDK

maxim = Maxim({"api_key": "your-api-key"})

import { Maxim } from '@maximai/maxim-js';

// Initialize Maxim SDK
const maxim = new Maxim({
  apiKey: 'your-api-key',
});

​

Basic Prompt Test Run

# Creating a test run

result = (
    maxim.create_test_run(
        name="Basic Prompt Evaluation", in_workspace_id="your-workspace-id"
    )
    .with_data_structure(
        {
            "input": "INPUT",
            "expected_output": "EXPECTED_OUTPUT",
        }
    )
    .with_data("dataset-id")
    .with_evaluators("Bias")
    .with_prompt_version_id("prompt-version-id")
    .run()
)

print(f"Test run completed! View results: {result.test_run_result.link}")

import { Maxim } from '@maximai/maxim-js';

// Initialize Maxim SDK
const maxim = new Maxim({
  apiKey: 'your-api-key',
});

// Create a test run
const result = await maxim
  .createTestRun('Basic Prompt Evaluation', 'your-workspace-id')
  .withDataStructure({
    Input: 'INPUT',
    'Expected Output': 'EXPECTED_OUTPUT',
  })
  .withData('dataset-id')
  .withEvaluators('Bias')
  .withPromptVersionId('prompt-version-id')
  .run();

console.log(`Test run completed! View results: ${result.testRunResult.link}`);

• createTestRun is the main function that creates a test run. It takes the name of the test run and the workspace id.
• withDataStructure is used to define the data structure of the dataset. It takes an object with the keys as the column names and the values as the column types.
• withData is used to specify the dataset to use for the test run. Can be a datasetId(string), a CSV file, an array of column to value mappings.
• withEvaluators is used to specify the evaluators to use/attach for the test run. You may create an evaluator locally through code or use an evaluator that is installed in your workspace through the name directly
• withPromptVersionId is used to specify the prompt version to use for the test run. It takes the id of the prompt version.
• run is used to execute the test run.

​

Next Steps

• Local Prompt Testing - Learn how to test prompts with custom logic
• Maxim Prompt Testing - Use prompts stored on the Maxim platform
• Simulation - Run AI-simulated multi-turn conversations
• Prompt Management - Retrieve and use prompts in production workflows
• CI/CD Integration - Automate prompt testing in your CI/CD pipeline