perplexity-hello-world

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".

⭐939stars🔀114forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill streamlines the initial integration process for the Perplexity API by generating minimal, functional 'Hello World' examples. It helps developers quickly verify their environment setup, ensure proper authentication, and understand core SDK patterns in both TypeScript and Python, significantly reducing the time required to move from documentation to a working prototype.

Use Cases

  • Environment Validation: Quickly test if your Perplexity API credentials and environment variables are correctly configured before starting complex development.
  • Rapid Scaffolding: Generate boilerplate code for new projects that require real-time web search and AI-powered information retrieval capabilities.
  • Educational Reference: Serve as a clear, functional starting point for developers learning the basic syntax and error-handling patterns of the Perplexity SDK.
  • Troubleshooting: Use the minimal working example to isolate issues when debugging more complex Perplexity integrations.
nameperplexity-hello-world
description|
allowed-toolsRead, Write, Edit
version1.0.0
licenseMIT
authorJeremy 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

Next Steps

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