Skip to content
juicebox-install-auth logo

Juicebox Install & Auth

juicebox-install-auth

Install and configure Juicebox SDK/CLI authentication. Use when setting up a new Juicebox integration, configuring API keys, or initializing Juicebox in your project. Trigger with phrases like "install juicebox", "setup juicebox", "juicebox auth", "configure juicebox API key".

SKILL.md

Full skill instructions

Juicebox Install & Auth

Overview

Set up Juicebox SDK and configure authentication credentials for the AI-powered people search platform.

Prerequisites

  • Node.js 18+ or Python 3.10+
  • Package manager (npm, pnpm, or pip)
  • Juicebox account with API access
  • API key from Juicebox dashboard

Instructions

Step 1: Install SDK

# Node.js
npm install @juicebox/​sdk

# Python
pip install juicebox-sdk

Step 2: Configure Authentication

# Set environment variable
export JUICEBOX_API_KEY="your-api-key"

# Or create .env file
echo 'JUICEBOX_API_KEY=your-api-key' >> .env

Step 3: Verify Connection

import { JuiceboxClient } from '@juicebox/​sdk';

const client = new JuiceboxClient({
  apiKey: process.env.JUICEBOX_API_KEY
});

const result = await client.search.test();
console.log(result.success ? 'OK' : 'Failed');

Output

  • Installed SDK package in node_modules or site-packages
  • Environment variable or .env file with API key
  • Successful connection verification output

Error Handling

ErrorCauseSolution
Invalid API KeyIncorrect or expired keyVerify key in Juicebox dashboard
Rate LimitedExceeded quotaCheck quota at https://juicebox.ai/docs
Network ErrorFirewall blockingEnsure outbound HTTPS allowed
Module Not FoundInstallation failedRun npm install or pip install again

Examples

TypeScript Setup

import { JuiceboxClient } from '@juicebox/​sdk';

const client = new JuiceboxClient({
  apiKey: process.env.JUICEBOX_API_KEY,
  timeout: 30000
});

Python Setup

from juicebox import JuiceboxClient
import os

client = JuiceboxClient(
    api_key=os.environ.get('JUICEBOX_API_KEY')
)

Resources

Next Steps

After successful auth, proceed to juicebox-hello-world for your first people search.