lindy-hello-world

Create a minimal working Lindy AI agent example.Use when starting a new Lindy integration, testing your setup,or learning basic Lindy API patterns.Trigger with phrases like "lindy hello world", "lindy example","lindy quick start", "simple lindy agent".

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

When & Why to Use This Skill

This Claude skill streamlines the onboarding process for Lindy AI by providing a minimal, functional 'Hello World' agent example. It is designed to help developers quickly validate their API setup, master core integration patterns, and deploy their first AI agent using standardized TypeScript or Python boilerplate code, significantly reducing the initial development friction.

Use Cases

  • Initial Integration Setup: Quickly generate a working template to verify that your Lindy API keys and environment variables are correctly configured.
  • Developer Onboarding: Learn the fundamental SDK methods for agent creation, instruction setting, and execution through clear, executable code examples.
  • Environment Troubleshooting: Isolate and debug connectivity or authentication issues by running a simplified, minimal agent script to confirm environment readiness.
  • Rapid Prototyping: Use the provided boilerplate as a reliable foundation to jumpstart the development of more complex, task-specific AI agents.
namelindy-hello-world
description|
allowed-toolsRead, Write, Edit
version1.0.0
licenseMIT
authorJeremy Longshore <jeremy@intentsolutions.io>

Lindy Hello World

Overview

Minimal working example demonstrating core Lindy AI agent functionality.

Prerequisites

  • Completed lindy-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 { Lindy } from '@lindy-ai/sdk';

const lindy = new Lindy({
  apiKey: process.env.LINDY_API_KEY,
});

Step 3: Create Your First Agent

async function main() {
  // Create a simple AI agent
  const agent = await lindy.agents.create({
    name: 'Hello World Agent',
    description: 'My first Lindy agent',
    instructions: 'You are a helpful assistant that greets users.',
  });

  console.log(`Created agent: ${agent.id}`);

  // Run the agent with a simple task
  const result = await lindy.agents.run(agent.id, {
    input: 'Say hello to the world!',
  });

  console.log(`Agent response: ${result.output}`);
}

main().catch(console.error);

Output

  • Working code file with Lindy client initialization
  • Created AI agent in your Lindy workspace
  • Console output showing:
Created agent: agt_abc123
Agent response: Hello, World! I'm your new Lindy AI assistant.

Error Handling

Error Cause Solution
Import Error SDK not installed Verify with npm list @lindy-ai/sdk
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 { Lindy } from '@lindy-ai/sdk';

const lindy = new Lindy({
  apiKey: process.env.LINDY_API_KEY,
});

async function main() {
  const agent = await lindy.agents.create({
    name: 'Greeting Agent',
    instructions: 'Greet users warmly and helpfully.',
  });

  const result = await lindy.agents.run(agent.id, {
    input: 'Hello!',
  });

  console.log(result.output);
}

main().catch(console.error);

Python Example

from lindy import Lindy

client = Lindy()

agent = client.agents.create(
    name="Greeting Agent",
    instructions="Greet users warmly and helpfully."
)

result = client.agents.run(agent.id, input="Hello!")
print(result.output)

Resources

Next Steps

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