praisonai 1.0.3 → 1.0.5

package/README.md

@@ -1,6 +1,6 @@
-# PraisonAI TypeScript Package
+# PraisonAI TypeScript Node.js AI Agents Framework
 
-A powerful TypeScript package for AI-driven tools and utilities.
+PraisonAI is a production-ready Multi AI Agents framework, designed to create AI Agents to automate and solve problems ranging from simple tasks to complex challenges. It provides a low-code solution to streamline the building and management of multi-agent LLM systems, emphasising simplicity, customisation, and effective human-agent collaboration.
 
 ## Installation
 
@@ -33,23 +33,30 @@ Here are examples of different ways to use PraisonAI:
 ### 1. Single Agent Example
 
 ```typescript
-import { SimpleAgent, OpenAIService } from 'praisonai';
+import { Agent, PraisonAIAgents } from 'praisonai';
 
 async function main() {
-    // Initialize a single agent with OpenAI
-    const llm = new OpenAIService({
-        apiKey: process.env.OPENAI_API_KEY
+    // Create a simple agent (no task specified)
+    const agent = new Agent({
+        name: "BiologyExpert",
+        instructions: "Explain the process of photosynthesis in detail.",
+        verbose: true
     });
-    
-    const agent = new SimpleAgent({
-        llm,
-        name: 'ResearchAssistant',
-        description: 'An AI assistant that helps with research tasks'
+
+    // Run the agent
+    const praisonAI = new PraisonAIAgents({
+        agents: [agent],
+        tasks: ["Explain the process of photosynthesis in detail."],
+        verbose: true
     });
 
-    // Execute a task
-    const response = await agent.execute('Summarize the key concepts of quantum computing');
-    console.log('Agent Response:', response);
+    try {
+        console.log('Starting single agent example...');
+        const results = await praisonAI.start();
+        console.log('\nFinal Results:', results);
+    } catch (error) {
+        console.error('Error:', error);
+    }
 }
 
 main();
@@ -58,32 +65,46 @@ main();
 ### 2. Multi-Agent Example
 
 ```typescript
-import { SimpleAgent, OpenAIService, MultiAgentSystem } from 'praisonai';
+import { Agent, PraisonAIAgents } from 'praisonai';
 
 async function main() {
-    const llm = new OpenAIService({
-        apiKey: process.env.OPENAI_API_KEY
+    // Create multiple agents with different roles
+    const researchAgent = new Agent({
+        name: "ResearchAgent",
+        instructions: "Research and provide detailed information about renewable energy sources.",
+        verbose: true
+    });
+
+    const summaryAgent = new Agent({
+        name: "SummaryAgent",
+        instructions: "Create a concise summary of the research findings about renewable energy sources. Use {previous_result} as input.",
+        verbose: true
     });
 
-    // Create multiple agents
-    const researcher = new SimpleAgent({
-        llm,
-        name: 'Researcher',
-        description: 'Researches and gathers information'
+    const recommendationAgent = new Agent({
+        name: "RecommendationAgent",
+        instructions: "Based on the summary in {previous_result}, provide specific recommendations for implementing renewable energy solutions.",
+        verbose: true
     });
 
-    const writer = new SimpleAgent({
-        llm,
-        name: 'Writer',
-        description: 'Writes and formats content'
+    // Run the agents in sequence
+    const praisonAI = new PraisonAIAgents({
+        agents: [researchAgent, summaryAgent, recommendationAgent],
+        tasks: [
+            "Research and analyze current renewable energy technologies and their implementation.",
+            "Summarize the key findings from the research.",
+            "Provide actionable recommendations based on the summary."
+        ],
+        verbose: true
     });
 
-    // Create multi-agent system
-    const system = new MultiAgentSystem([researcher, writer]);
-    
-    // Execute collaborative task
-    const result = await system.execute('Research and write a summary about AI agents');
-    console.log('Multi-Agent Result:', result);
+    try {
+        console.log('Starting multi-agent example...');
+        const results = await praisonAI.start();
+        console.log('\nFinal Results:', results);
+    } catch (error) {
+        console.error('Error:', error);
+    }
 }
 
 main();
@@ -92,31 +113,66 @@ main();
 ### 3. Task-Based Agent Example
 
 ```typescript
-import { SimpleAgent, OpenAIService, Task, ArxivSearchTool } from 'praisonai';
+import { Agent, Task, PraisonAIAgents } from 'praisonai';
 
 async function main() {
-    const llm = new OpenAIService({
-        apiKey: process.env.OPENAI_API_KEY
+    // Create agents first
+    const dietAgent = new Agent({
+        name: "DietAgent",
+        role: "Nutrition Expert",
+        goal: "Create healthy and delicious recipes",
+        backstory: "You are a certified nutritionist with years of experience in creating balanced meal plans.",
+        verbose: true,  // Enable streaming output
+        instructions: `You are a professional chef and nutritionist. Create 5 healthy food recipes that are both nutritious and delicious.
+Each recipe should include:
+1. Recipe name
+2. List of ingredients with quantities
+3. Step-by-step cooking instructions
+4. Nutritional information
+5. Health benefits
+
+Format your response in markdown.`
+    });
+
+    const blogAgent = new Agent({
+        name: "BlogAgent",
+        role: "Food Blogger",
+        goal: "Write engaging blog posts about food and recipes",
+        backstory: "You are a successful food blogger known for your ability to make recipes sound delicious and approachable.",
+        verbose: true,  // Enable streaming output
+        instructions: `You are a food and health blogger. Write an engaging blog post about the provided recipes.
+The blog post should:
+1. Have an engaging title
+2. Include an introduction about healthy eating`
+    });
+
+    // Create tasks
+    const createRecipesTask = new Task({
+        name: "Create Recipes",
+        description: "Create 5 healthy and delicious recipes",
+        agent: dietAgent
     });
 
-    // Create agent with tools
-    const agent = new SimpleAgent({
-        llm,
-        name: 'ResearchAgent',
-        tools: [new ArxivSearchTool()]
+    const writeBlogTask = new Task({
+        name: "Write Blog",
+        description: "Write a blog post about the recipes",
+        agent: blogAgent,
+        dependencies: [createRecipesTask]  // This task depends on the recipes being created first
     });
 
-    // Create and execute a task
-    const task = new Task({
-        objective: 'Find recent quantum computing papers',
-        steps: [
-            'Search for quantum computing papers',
-            'Summarize the findings'
-        ]
+    // Run the tasks
+    const praisonAI = new PraisonAIAgents({
+        tasks: [createRecipesTask, writeBlogTask],
+        verbose: true
     });
 
-    const result = await agent.executeTask(task);
-    console.log('Task Result:', result);
+    try {
+        console.log('Starting task-based example...');
+        const results = await praisonAI.start();
+        console.log('\nFinal Results:', results);
+    } catch (error) {
+        console.error('Error:', error);
+    }
 }
 
 main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "praisonai",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "PraisonAI TypeScript AI Agents Framework - Node.js, npm, and Javascript AI Agents Framework",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",