Getting Started with AGNT5

In this guide we will:

Create an agnt5.dev account
Install the AGNT5 SDK
Create your first workflow
Deploy and test

Choose Your Setup Method

Install AGNT5 CLI

npm install -g @agnt5/cli

Create a new project

agnt5 init my-first-agent
cd my-first-agent

Run your agent

agnt5 dev

Install Python SDK

pip install agnt5

Create your first workflow

from agnt5 import Workflow, task

@task
def greet(name: str) -> str:
    return f"Hello, {name}!"

workflow = Workflow("greeting-workflow")
workflow.add_task(greet)

if __name__ == "__main__":
    result = workflow.run(name="World")
    print(result)

Install Node.js SDK

npm install @agnt5/sdk

Create your first workflow

import { Workflow, task } from '@agnt5/sdk';

const greet = task(async (name) => {
  return `Hello, ${name}!`;
});

const workflow = new Workflow('greeting-workflow');
workflow.addTask(greet);

// Run the workflow
const result = await workflow.run({ name: 'World' });
console.log(result);

Create Your First Agent

Once you have AGNT5 set up, let’s create a simple agent that can process tasks:

from agnt5 import Agent, Workflow

# Define your agent's workflow
@workflow
def customer_support_agent():
    """A simple customer support agent"""
    # Your agent logic here
    pass

# Deploy your agent
agent = Agent("customer-support")
agent.deploy(customer_support_agent)

Pro tip: Start with the CLI approach if you’re new to AGNT5. It provides the fastest way to get up and running with sensible defaults and built-in examples.

Next Steps

Now that you have AGNT5 running, you can:

Learn about Workflows - Understand how to structure your agent logic
Explore Tasks - Break down complex operations into manageable pieces
Set up Integrations - Connect your agents to external services
Manage Secrets - Securely handle API keys and sensitive data

Need Help?

If you encounter any issues during setup:

Check our documentation
Visit our GitHub repository
Join our community discussions