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".
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.
| name | perplexity-hello-world |
|---|---|
| description | | |
| 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-authsetup - 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.