pip install praisonaiagents

from praisonaiagents import Agent, Task, AgentTeam

agent = Agent(
    name="Developer",
    role="Software Developer",
    goal="Implement features"
)

task = Task(
    description="Build a REST API",
    agent=agent
)

from praisonaiagents import AgentFlowPlanningConfig

agents = AgentTeam(
    agents=[agent],
    tasks=[task],
    planning=WorkflowPlanningConfig(enabled=True, llm="gpt-4o-mini")
)

result = agents.start()

from praisonaiagents.planning import Plan, PlanStep

plan = Plan(
    title="Build REST API",
    description="Implementation plan for REST API",
    steps=[
        PlanStep(
            title="Set up project structure",
            description="Create directories and files",
            status="pending"
        ),
        PlanStep(
            title="Implement endpoints",
            description="Create API endpoints",
            status="pending"
        )
    ]
)

from praisonaiagents.planning import PlanStep

step = PlanStep(
    title="Implement authentication",
    description="Add JWT authentication",
    status="pending",  # pending, in_progress, completed, failed
    dependencies=["step_1"],
    estimated_time="30 minutes"
)

from praisonaiagents.planning import TodoList, TodoItem

todo = TodoList()
todo.add(TodoItem(
    title="Research API frameworks",
    priority="high"
))
todo.add(TodoItem(
    title="Write tests",
    priority="medium"
))

# Mark as complete
todo.complete("Research API frameworks")

from praisonaiagents.planning import TodoItem

item = TodoItem(
    title="Implement feature",
    description="Add new feature",
    priority="high",  # high, medium, low
    status="pending"
)

from praisonaiagents.planning import PlanStorage

storage = PlanStorage(path=".praison/plans")

# Save a plan
storage.save(plan)

# Load a plan
loaded_plan = storage.load("plan_id")

# List all plans
plans = storage.list_all()

from praisonaiagents.planning import PlanningAgent

planner = PlanningAgent(
    llm="gpt-4o-mini",
    
)

plan = planner.create_plan(
    task="Build a REST API with authentication",
    context="Using FastAPI framework"
)

from praisonaiagents.planning import ApprovalCallback

def my_approval(plan):
    print(f"Plan: {plan.title}")
    for step in plan.steps:
        print(f"  - {step.title}")
    return input("Approve? (y/n): ").lower() == "y"

callback = ApprovalCallback(approval_func=my_approval)

from praisonaiagents.planning import READ_ONLY_TOOLS

# Includes:
# - read_file, list_directory, search_codebase
# - search_files, grep_search, find_files
# - web_search, get_file_content, list_files
# - read_document, search_web, fetch_url, get_context

from praisonaiagents.planning import RESTRICTED_TOOLS

# Includes:
# - write_file, create_file, delete_file
# - execute_command, run_command, shell_command
# - modify_file, edit_file, remove_file
# - move_file, copy_file, mkdir, rmdir
# - git_commit, git_push, npm_install, pip_install

from praisonaiagents.planning import RESEARCH_TOOLS

# Includes:
# - web_search, search_web, duckduckgo_search
# - tavily_search, brave_search, google_search
# - read_url, fetch_url, read_file
# - list_directory, search_codebase
# - grep_search, find_files

from praisonaiagents import Agent, Task, AgentTeam

agent = Agent(
    name="Developer",
    role="Full Stack Developer",
    goal="Build web applications"
)

task = Task(
    description="Create a blog application with user authentication",
    expected_output="A working blog application",
    agent=agent
)

# Enable planning mode
agents = AgentTeam(
    agents=[agent],
    tasks=[task],
    planning=True
)

result = agents.start()

from praisonaiagents import AgentFlowPlanningConfig

agents = AgentTeam(
    agents=[agent],
    tasks=[task],
    planning=WorkflowPlanningConfig(enabled=True, llm="gpt-4o")
)

from praisonaiagents.planning import Plan, PlanStep, PlanStorage

# Create a plan manually
plan = Plan(
    title="API Development",
    steps=[
        PlanStep(title="Design API schema", status="completed"),
        PlanStep(title="Implement endpoints", status="in_progress"),
        PlanStep(title="Write tests", status="pending"),
        PlanStep(title="Deploy", status="pending")
    ]
)

# Save to storage
storage = PlanStorage()
storage.save(plan)

from praisonaiagents.planning import PlanningAgent, ApprovalCallback

def approve_plan(plan):
    print("\n=== Plan Review ===")
    print(f"Title: {plan.title}")
    print("\nSteps:")
    for i, step in enumerate(plan.steps, 1):
        print(f"  {i}. {step.title}")
    
    response = input("\nApprove this plan? (y/n): ")
    return response.lower() == "y"

planner = PlanningAgent(
    approval_callback=ApprovalCallback(approval_func=approve_plan)
)