​
Quick Start

Create multiple AI agents that can work together in just a few lines of code!

1

Install Package

First, install the PraisonAI Agents package:

pip install praisonaiagents duckduckgo_search
2

Set API Key

Set your OpenAI API key as an environment variable in your terminal:

export OPENAI_API_KEY=your_api_key_here
3

Create Your Agents

from praisonaiagents import Agent, PraisonAIAgents
summarise_agent = Agent(instructions="Summarise Photosynthesis")
agents = PraisonAIAgents(agents=[summarise_agent])
agents.start()
4

Run Your Agents

Execute your agents by running:

python app.py

Prerequisites

  • Python 3.10 or higher
  • OpenAI API key. Generate OpenAI API key here. Use Other models using this guide.


​
Understanding Mini AI Agents

What are Mini AI Agents?

Mini AI Agents are simplified yet powerful AI agents that can:

  • Work together to accomplish tasks
  • Use tools like internet search
  • Process and summarize information
  • Execute tasks sequentially

​
Key Components

Agent

Individual AI agents with specific roles and capabilities

Agent(instructions="Your agent's role description")

Tools

Built-in tools that agents can use

tools=[Tools.internet_search]

Agents Manager

Coordinates multiple agents

Agents(agents=[agent1, agent2])

Sequential Flow

Agents work in sequence, passing results to each other

​
Available Tools

Internet Search

Tools.internet_search

Search the internet using DuckDuckGo

Requires: pip install duckduckgo_search

​
Custom Instructions

# Simple instructions
research_agent = Agent(
    instructions="Research about climate change"
)

​
Best Practices

​
Common Patterns

​
Research and Analysis

# Research agent
researcher = Agent(
    instructions="Research latest developments in quantum computing",
    tools=[Tools.internet_search]
)

# Analysis agent
analyst = Agent(
    instructions="Analyze and explain the research findings in simple terms"
)

agents = Agents(agents=[researcher, analyst])

​
Information Processing

# Data collector
collector = Agent(
    instructions="Collect information about renewable energy",
    tools=[Tools.internet_search]
)

# Summarizer
summarizer = Agent(
    instructions="Create a concise summary of the collected information"
)

# Report writer
writer = Agent(
    instructions="Write a detailed report based on the summary"
)

agents = Agents(agents=[collector, summarizer, writer])

​
Troubleshooting

Tool Not Available

If using Tools.internet_search, install required package:

pip install duckduckgo_search

Agent Communication

Ensure agent instructions are clear and complementary

​
Next Steps

Advanced Agents

Learn about advanced agent configurations

Custom Tools

Create your own agent tools

Mini AI Agents are designed to be simple yet powerful. They’re perfect for quick prototypes and straightforward automation tasks.