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
bash
# Node.js npm install @juicebox/sdk # Python pip install juicebox-sdk
Step 2: Configure Authentication
bash
# 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
typescript
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
| Error | Cause | Solution |
|---|---|---|
| Invalid API Key | Incorrect or expired key | Verify key in Juicebox dashboard |
| Rate Limited | Exceeded quota | Check quota at https://juicebox.ai/docs |
| Network Error | Firewall blocking | Ensure outbound HTTPS allowed |
| Module Not Found | Installation failed | Run npm install or pip install again |
Examples
TypeScript Setup
typescript
import { JuiceboxClient } from '@juicebox/sdk';
const client = new JuiceboxClient({
apiKey: process.env.JUICEBOX_API_KEY,
timeout: 30000
});
Python Setup
python
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.