---

name: perplexity-hello-world description: | Create a minimal working Perplexity example. Use when starting a new Perplexity integration, testing your setup, or learning basic Perplexity API patterns. Trigger with phrases like "perplexity hello world", "perplexity example", "perplexity quick start", "simple perplexity code". allowed-tools: Read, Write, Edit version: 1.0.0 license: MIT author: Jeremy Longshore jeremy@intentsolutions.io

Perplexity Hello World

Overview

Minimal working example demonstrating core Perplexity functionality.

Prerequisites

• Completed perplexity-install-auth setup
• Valid API credentials configured
• Development environment ready

Instructions

Step 1: Create Entry File

Create a new file for your hello world example.

Step 2: Import and Initialize Client

import { PerplexityClient } from '@perplexity/sdk';

const client = new PerplexityClient({
  apiKey: process.env.PERPLEXITY_API_KEY,
});

Step 3: Make Your First API Call

async function main() {
  // Your first API call here
}

main().catch(console.error);

Output

• Working code file with Perplexity client initialization
• Successful API response confirming connection
• Console output showing:

Success! Your Perplexity connection is working.

Error Handling

| Error | Cause | Solution | |-------|-------|----------| | Import Error | SDK not installed | Verify with npm list or pip show | | Auth Error | Invalid credentials | Check environment variable is set | | Timeout | Network issues | Increase timeout or check connectivity | | Rate Limit | Too many requests | Wait and retry with exponential backoff |

Examples

TypeScript Example

import { PerplexityClient } from '@perplexity/sdk';

const client = new PerplexityClient({
  apiKey: process.env.PERPLEXITY_API_KEY,
});

async function main() {
  // Your first API call here
}

main().catch(console.error);

Python Example

from perplexity import PerplexityClient

client = PerplexityClient()

# Your first API call here

Resources

• Perplexity Getting Started
• Perplexity API Reference
• Perplexity Examples

Next Steps

Proceed to perplexity-local-dev-loop for development workflow setup.