Installation

LaunchGate offers multiple integration options depending on your workflow.

SDK (recommended)

The JavaScript/TypeScript SDK is the primary way to integrate LaunchGate into your application.

npm install @launchgate/sdk

pnpm add @launchgate/sdk

yarn add @launchgate/sdk

Requirements

• Node.js 18 or later
• TypeScript 5.0+ (optional but recommended)

CLI

The command-line interface is ideal for running evals from scripts, CI/CD pipelines, or the terminal.

npm install -g @launchgate/cli

# Run without installing globally
npx @launchgate/cli run my-suite --output "..."

GitHub Action

Add LaunchGate to your GitHub Actions workflows for automated PR gating.

- name: Run LaunchGate Eval
  uses: launchgate/eval-action@v1
  with:
    api-key: ${{ secrets.LAUNCHGATE_API_KEY }}
    suite: "my-suite"
    output: ${{ steps.generate.outputs.text }}

No installation required — the action runs directly in your GitHub workflow.

REST API

If you’re not using JavaScript/TypeScript, you can integrate directly with the REST API.

curl -X POST https://api.launchgate.ai/v1/run \
  -H "Authorization: Bearer lg_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "suite": "my-suite",
    "output": "The AI-generated output to evaluate",
    "input": { "context": "..." }
  }'

See the API Reference for full endpoint documentation.