Merge pull request #983 from Dhivya-Bharathy/models-providers-reorganization

MervinPraison · web-flow · commit 3c9ef953143b · 2025-07-18T11:30:39.000+01:00
feat: Add comprehensive provider examples for all major LiteLLM providers with clean API structure
diff --git a/examples/python/models/claude/claude_creative_designer_agent.py b/examples/python/models/claude/claude_creative_designer_agent.py
@@ -0,0 +1,12 @@
+from praisonaiagents import Agent
+
+agent = Agent(
+    instructions="You are a creative designer AI agent. "
+                "Help users with graphic design concepts, branding strategies, "
+                "visual communication, and creative problem-solving. Provide guidance "
+                "on design principles, color theory, typography, and user experience.",
+    llm="anthropic/claude-3-5-sonnet-20241022"
+)
+
+response = agent.start("Hello! I'm your creative designer assistant. "
+                      "How can I help you with your design projects today?") 
diff --git a/examples/python/models/claude/claude_educational_tutor_agent.py b/examples/python/models/claude/claude_educational_tutor_agent.py
@@ -0,0 +1,12 @@
+from praisonaiagents import Agent
+
+agent = Agent(
+    instructions="You are an educational tutor AI agent. "
+                "Help students learn various subjects, explain complex concepts, "
+                "provide step-by-step solutions, and create personalized learning "
+                "materials for different educational levels.",
+    llm="anthropic/claude-3-5-sonnet-20241022"
+)
+
+response = agent.start("Hello! I'm your educational tutor assistant. "
+                      "How can I help you learn today?") 
diff --git a/examples/python/models/claude/claude_financial_advisor_agent.py b/examples/python/models/claude/claude_financial_advisor_agent.py
@@ -0,0 +1,12 @@
+from praisonaiagents import Agent
+
+agent = Agent(
+    instructions="You are a financial advisor AI agent. "
+                "Help users understand financial concepts, analyze investment opportunities, "
+                "and provide guidance on personal finance, budgeting, and financial planning. "
+                "Note: This is for educational purposes only, not financial advice.",
+    llm="anthropic/claude-3-5-sonnet-20241022"
+)
+
+response = agent.start("Hello! I'm your financial advisor assistant. "
+                      "How can I help you understand financial concepts today?") 
diff --git a/examples/python/models/claude/claude_legal_advisor_agent.py b/examples/python/models/claude/claude_legal_advisor_agent.py
@@ -0,0 +1,12 @@
+from praisonaiagents import Agent
+
+agent = Agent(
+    instructions="You are a legal advisor AI agent. "
+                "Help users understand legal concepts, review contracts, "
+                "analyze legal documents, and provide guidance on compliance "
+                "and regulatory requirements. Note: This is for educational purposes only.",
+    llm="anthropic/claude-3-5-sonnet-20241022"
+)
+
+response = agent.start("Hello! I'm your legal advisor assistant. "
+                      "How can I help you understand legal concepts today?") 
diff --git a/examples/python/models/claude/claude_medical_researcher_agent.py b/examples/python/models/claude/claude_medical_researcher_agent.py
@@ -0,0 +1,12 @@
+from praisonaiagents import Agent
+
+agent = Agent(
+    instructions="You are a medical research AI agent. "
+                "Help users understand medical concepts, analyze research papers, "
+                "and provide insights on healthcare trends and developments. "
+                "Note: This is for educational purposes only, not medical advice.",
+    llm="anthropic/claude-3-5-sonnet-20241022"
+)
+
+response = agent.start("Hello! I'm your medical research assistant. "
+                      "How can I help you understand medical concepts today?") 
diff --git a/examples/python/models/gpt/gpt_cybersecurity_agent.py b/examples/python/models/gpt/gpt_cybersecurity_agent.py
@@ -0,0 +1,12 @@
+from praisonaiagents import Agent
+
+agent = Agent(
+    instructions="You are a cybersecurity AI agent. "
+                "Help users understand security concepts, analyze security threats, "
+                "and provide guidance on security best practices, risk assessment, "
+                "and security architecture design.",
+    llm="openai/gpt-4o"
+)
+
+response = agent.start("Hello! I'm your cybersecurity assistant. "
+                      "How can I help you with security concepts today?") 
diff --git a/examples/python/models/gpt/gpt_data_engineer_agent.py b/examples/python/models/gpt/gpt_data_engineer_agent.py
@@ -0,0 +1,12 @@
+from praisonaiagents import Agent
+
+agent = Agent(
+    instructions="You are a data engineer AI agent. "
+                "Help users design data pipelines, optimize database performance, "
+                "create ETL processes, and provide guidance on data architecture, "
+                "data modeling, and big data technologies.",
+    llm="openai/gpt-4o"
+)
+
+response = agent.start("Hello! I'm your data engineer assistant. "
+                      "How can I help you with your data engineering projects today?") 
diff --git a/examples/python/models/gpt/gpt_marketing_strategist_agent.py b/examples/python/models/gpt/gpt_marketing_strategist_agent.py
@@ -0,0 +1,12 @@
+from praisonaiagents import Agent
+
+agent = Agent(
+    instructions="You are a marketing strategist AI agent. "
+                "Help users develop marketing strategies, analyze market trends, "
+                "create campaign plans, and provide guidance on digital marketing, "
+                "brand positioning, and customer acquisition strategies.",
+    llm="openai/gpt-4o"
+)
+
+response = agent.start("Hello! I'm your marketing strategist assistant. "
+                      "How can I help you with your marketing strategy today?") 
diff --git a/examples/python/models/gpt/gpt_product_manager_agent.py b/examples/python/models/gpt/gpt_product_manager_agent.py
@@ -0,0 +1,12 @@
+from praisonaiagents import Agent
+
+agent = Agent(
+    instructions="You are a product manager AI agent. "
+                "Help users with product strategy, feature prioritization, "
+                "user research analysis, and product roadmap planning. Provide "
+                "guidance on market analysis, competitive positioning, and user experience.",
+    llm="openai/gpt-4o"
+)
+
+response = agent.start("Hello! I'm your product manager assistant. "
+                      "How can I help you with your product strategy today?") 
diff --git a/examples/python/models/gpt/gpt_software_architect_agent.py b/examples/python/models/gpt/gpt_software_architect_agent.py
@@ -0,0 +1,12 @@
+from praisonaiagents import Agent
+
+agent = Agent(
+    instructions="You are a software architect AI agent. "
+                "Help users design software systems, create architecture diagrams, "
+                "plan system integrations, and provide guidance on scalability, "
+                "security, and best practices for software development.",
+    llm="openai/gpt-4o"
+)
+
+response = agent.start("Hello! I'm your software architect assistant. "
+                      "How can I help you design your software system today?") 
diff --git a/examples/python/models/llama/llama_business_analyst_agent.py b/examples/python/models/llama/llama_business_analyst_agent.py
@@ -0,0 +1,12 @@
+from praisonaiagents import Agent
+
+agent = Agent(
+    instructions="You are a business analyst AI agent. "
+                "Help users analyze business performance, market trends, "
+                "competitive landscape, and strategic opportunities. Provide insights "
+                "on business metrics, financial analysis, and growth strategies.",
+    llm="meta-llama/Llama-3.1-8B-Instruct"
+)
+
+response = agent.start("Hello! I'm your business analyst assistant. "
+                      "How can I help you analyze your business data and strategies today?") 
diff --git a/examples/python/models/llama/llama_code_review_agent.py b/examples/python/models/llama/llama_code_review_agent.py
@@ -0,0 +1,12 @@
+from praisonaiagents import Agent
+
+agent = Agent(
+    instructions="You are a code review AI agent. "
+                "Help developers review code for best practices, security vulnerabilities, "
+                "performance issues, and maintainability. Provide constructive feedback "
+                "and suggest improvements for code quality and efficiency.",
+    llm="meta-llama/Llama-3.1-8B-Instruct"
+)
+
+response = agent.start("Hello! I'm your code review assistant. "
+                      "How can I help you improve your code quality today?") 
diff --git a/examples/python/models/llama/llama_content_writer_agent.py b/examples/python/models/llama/llama_content_writer_agent.py
@@ -0,0 +1,12 @@
+from praisonaiagents import Agent
+
+agent = Agent(
+    instructions="You are a content writing AI agent. "
+                "Help users create engaging blog posts, articles, marketing copy, "
+                "and social media content. Provide guidance on SEO optimization, "
+                "content structure, tone adjustment, and audience targeting.",
+    llm="meta-llama/Llama-3.1-8B-Instruct"
+)
+
+response = agent.start("Hello! I'm your content writing assistant. "
+                      "How can I help you create compelling content today?") 
diff --git a/examples/python/models/llama/llama_data_science_agent.py b/examples/python/models/llama/llama_data_science_agent.py
@@ -0,0 +1,12 @@
+from praisonaiagents import Agent
+
+agent = Agent(
+    instructions="You are a data science AI agent. "
+                "Help users with data analysis, machine learning model development, "
+                "statistical analysis, and data visualization. Provide guidance on "
+                "data preprocessing, feature engineering, model selection, and evaluation.",
+    llm="meta-llama/Llama-3.1-8B-Instruct"
+)
+
+response = agent.start("Hello! I'm your data science assistant. "
+                      "How can I help you with your data analysis and machine learning projects today?") 
diff --git a/examples/python/models/llama/llama_research_assistant_agent.py b/examples/python/models/llama/llama_research_assistant_agent.py
@@ -0,0 +1,12 @@
+from praisonaiagents import Agent
+
+agent = Agent(
+    instructions="You are a research assistant AI agent. "
+                "Help users conduct comprehensive research on various topics, "
+                "analyze academic papers, synthesize information, and provide "
+                "evidence-based insights and recommendations.",
+    llm="meta-llama/Llama-3.1-8B-Instruct"
+)
+
+response = agent.start("Hello! I'm your research assistant. "
+                      "How can I help you with your research project today?") 
diff --git a/examples/python/providers/ai21/ai21_example.py b/examples/python/providers/ai21/ai21_example.py
@@ -0,0 +1,31 @@
+"""
+Basic example of using AI21 with PraisonAI
+"""
+
+from praisonaiagents import Agent
+
+# Initialize Agent with AI21
+agent = Agent(
+    instructions="You are a helpful assistant",
+    llm="ai21/j2-ultra",
+)
+
+# Example conversation
+response = agent.start("Hello! Can you help me with a writing task?")
+
+# Example with creative writing
+writing_task = """
+Write a short story about a time traveler who discovers 
+they can only travel to moments of great historical significance.
+Make it engaging and about 200 words.
+"""
+
+response = agent.start(writing_task)
+
+# Example with reasoning
+reasoning_task = """
+Explain the concept of quantum entanglement in simple terms,
+and then discuss its potential applications in quantum computing.
+"""
+
+response = agent.start(reasoning_task) 
diff --git a/examples/python/providers/aws/aws_bedrock_example.py b/examples/python/providers/aws/aws_bedrock_example.py
@@ -0,0 +1,31 @@
+"""
+Basic example of using AWS Bedrock with PraisonAI
+"""
+
+from praisonaiagents import Agent
+
+# Initialize Agent with AWS Bedrock (Claude)
+agent = Agent(
+    instructions="You are a helpful assistant",
+    llm="bedrock/anthropic.claude-3-5-sonnet-20241022-v2:0",
+)
+
+# Example conversation
+response = agent.start("Hello! Can you help me with a writing task?")
+
+# Example with creative writing
+writing_task = """
+Write a short story about a time traveler who discovers 
+they can only travel to moments of great historical significance.
+Make it engaging and about 200 words.
+"""
+
+response = agent.start(writing_task)
+
+# Example with reasoning
+reasoning_task = """
+Explain the concept of quantum entanglement in simple terms,
+and then discuss its potential applications in quantum computing.
+"""
+
+response = agent.start(reasoning_task) 
diff --git a/examples/python/providers/azure/azure_openai_example.py b/examples/python/providers/azure/azure_openai_example.py
@@ -0,0 +1,30 @@
+"""
+Basic example of using Azure OpenAI with PraisonAI
+"""
+
+from praisonaiagents import Agent
+
+# Initialize Agent with Azure OpenAI
+agent = Agent(
+    instructions="You are a helpful assistant",
+    llm="azure/gpt-4",
+)
+
+# Example conversation
+response = agent.start("Hello! Can you help me with a coding task?")
+
+# Example with code generation
+coding_task = """
+Write a Python function that implements a binary search algorithm.
+Include proper documentation and error handling.
+"""
+
+response = agent.start(coding_task)
+
+# Example with analysis
+analysis_task = """
+Analyze the pros and cons of using microservices architecture 
+for a large-scale e-commerce application.
+"""
+
+response = agent.start(analysis_task) 
diff --git a/examples/python/providers/cloudflare/cloudflare_example.py b/examples/python/providers/cloudflare/cloudflare_example.py
@@ -0,0 +1,30 @@
+"""
+Basic example of using Cloudflare AI with PraisonAI
+"""
+
+from praisonaiagents import Agent
+
+# Initialize Agent with Cloudflare AI
+agent = Agent(
+    instructions="You are a helpful assistant",
+    llm="cloudflare/@cf/meta/llama-3.1-8b-instruct",
+)
+
+# Example conversation
+response = agent.start("Hello! Can you help me with a coding task?")
+
+# Example with code generation
+coding_task = """
+Write a Python function that implements a binary search algorithm.
+Include proper documentation and error handling.
+"""
+
+response = agent.start(coding_task)
+
+# Example with analysis
+analysis_task = """
+Analyze the pros and cons of using microservices architecture 
+for a large-scale e-commerce application.
+"""
+
+response = agent.start(analysis_task) 
diff --git a/examples/python/providers/databricks/databricks_example.py b/examples/python/providers/databricks/databricks_example.py
@@ -0,0 +1,31 @@
+"""
+Basic example of using Databricks with PraisonAI
+"""
+
+from praisonaiagents import Agent
+
+# Initialize Agent with Databricks
+agent = Agent(
+    instructions="You are a helpful assistant",
+    llm="databricks/databricks-llama-3.1-8b-instruct",
+)
+
+# Example conversation
+response = agent.start("Hello! Can you help me with a data analysis task?")
+
+# Example with data analysis
+analysis_task = """
+Analyze the potential market opportunities for a new AI-powered 
+productivity tool targeting remote workers. Include market size, 
+competitive landscape, and go-to-market strategy recommendations.
+"""
+
+response = agent.start(analysis_task)
+
+# Example with business intelligence
+business_task = """
+Provide insights on how AI can transform customer service operations
+in the next 5 years, including specific use cases and implementation strategies.
+"""
+
+response = agent.start(business_task) 
diff --git a/examples/python/providers/fireworks/fireworks_example.py b/examples/python/providers/fireworks/fireworks_example.py
diff --git a/examples/python/providers/huggingface/huggingface_example.py b/examples/python/providers/huggingface/huggingface_example.py
diff --git a/examples/python/providers/moonshot/moonshot_example.py b/examples/python/providers/moonshot/moonshot_example.py
diff --git a/examples/python/providers/openrouter/openrouter_example.py b/examples/python/providers/openrouter/openrouter_example.py
diff --git a/examples/python/providers/perplexity/perplexity_example.py b/examples/python/providers/perplexity/perplexity_example.py
diff --git a/examples/python/providers/replicate/replicate_example.py b/examples/python/providers/replicate/replicate_example.py
diff --git a/examples/python/providers/sagemaker/sagemaker_example.py b/examples/python/providers/sagemaker/sagemaker_example.py
diff --git a/examples/python/providers/together/together_ai_example.py b/examples/python/providers/together/together_ai_example.py
diff --git a/examples/python/providers/vertex/vertex_example.py b/examples/python/providers/vertex/vertex_example.py
diff --git a/examples/python/providers/vllm/vllm_example.py b/examples/python/providers/vllm/vllm_example.py
