---

name: lindy-hello-world description: | 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". allowed-tools: Read, Write, Edit version: 1.0.0 license: MIT author: Jeremy 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

Copyimport { Lindy } from '@lindy-ai/sdk';

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

Step 3: Create Your First Agent

Copyasync 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:

CopyCreated agent: agt_abc123
Agent response: Hello, World! I'm your new Lindy AI assistant.

Error Handling

Examples

TypeScript Example

Copyimport { 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

Copyfrom 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

• Lindy Getting Started
• Lindy API Reference
• Lindy Examples

Next Steps

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