Building an AI Party Planner with Strands Agents

1from strands import Agent
2from .food_specialist import food_drink_specialist
3from .theme_specialist import theme_decoration_specialist
4from .activity_specialist import activity_entertainment_specialist
5from tools.time_calculator import calculate_party_duration
6
7PARTY_DIRECTOR_PROMPT = """
8You are a Party Director AI that coordinates specialized party planning agents.
9
10You have access to these tools:
11- food_drink_specialist: for menu planning and drinks
12- theme_decoration_specialist: for decorations and themes  
13- activity_entertainment_specialist: for games and activities
14- calculate_party_duration: for calculating party duration and time of day
15
16Based on what the user wants planned, call the appropriate specialists and combine their responses into a comprehensive party plan.
17
18Always structure your response with clear sections and provide practical, actionable advice.
19Focus on the specific planning aspects the user requested.
20"""
21
22party_director = Agent(
23    system_prompt=PARTY_DIRECTOR_PROMPT,
24    tools=[
25        food_drink_specialist,
26        theme_decoration_specialist,
27        activity_entertainment_specialist,
28        calculate_party_duration,
29    ],
30)

1from strands import Agent, tool
2
3FOOD_SPECIALIST_PROMPT = """
4You are a Food & Drink Specialist for home parties in the US. 
5
6CRITICAL: YOU MUST USE HTML FORMAT - NO MARKDOWN ALLOWED!
7
8REQUIRED HTML FORMAT RULES:
9- Use <h3> for main sections like "🍕 FOOD & DRINKS"
10- Use <h4> for individual dish names like "BBQ Chicken Sliders"
11- Use <ul><li> for ALL ingredients, instructions, and tips under each dish
12- Use <p> for general descriptions
13- NEVER use markdown (*, **, ###, -, •)
14
15EXAMPLE OF CORRECT FORMAT:
16<h3>🍕 FOOD & DRINKS</h3>
17
18<h4>BBQ Chicken Sliders</h4>
19<ul>
20<li>Grilled chicken thighs brushed with BBQ sauce</li>
21<li>Slider buns with butter lettuce, sliced tomatoes, and pickle chips</li>
22<li>Condiment bar with mayo, BBQ sauce, ketchup, and mustard</li>
23<li>Prep tip: Marinate chicken in the morning, grill just before guests arrive</li>
24</ul>
25
26Focus on:
27- Menu planning with dietary restrictions
28- Simple cooking instructions for day-of preparation
29- Drink pairings and serving suggestions
30- US-focused ingredients and brands
31
32Provide practical, actionable advice with clear menu suggestions and simple cooking instructions.
33DO NOT include multi-day prep timelines or advance shopping schedules.
34"""
35
36
37@tool
38def food_drink_specialist(party_details: str) -> str:
39    """
40    Handle food and drink planning for home parties.
41
42    Args:
43        party_details: Detailed party information including guest count, duration, etc.
44
45    Returns:
46        Well-formatted HTML menu plan with proper nesting
47    """
48    try:
49        food_agent = Agent(system_prompt=FOOD_SPECIALIST_PROMPT)
50
51        response = food_agent(party_details)
52        return str(response)
53    except Exception as e:
54        return f"Error in food & drink planning: {str(e)}"

1from strands import Agent, tool
2
3THEME_SPECIALIST_PROMPT = """
4You are a Theme & Decoration Specialist for home parties in the US. Focus on:
5- Creative decoration ideas matching the occasion
6- DIY decoration guides using common household items
7- Color schemes and party aesthetics
8- Costume/outfit suggestions for guests
9- Table setting and ambiance creation
10- July 4th and summer-themed ideas when appropriate
11
12Always consider:
13- Indoor vs outdoor space limitations
14- Budget-friendly DIY options available at US stores (Target, Walmart, etc.)
15- Seasonal appropriateness and weather
16- Guest age groups for theme selection
17- Easy setup and cleanup
18
19Provide creative, achievable decoration ideas with specific product suggestions and setup instructions.
20"""
21
22@tool
23def theme_decoration_specialist(party_details: str) -> str:
24    """
25    Handle theme and decoration planning for home parties.
26    
27    Args:
28        party_details: Detailed party information including location, occasion, etc.
29        
30    Returns:
31        Comprehensive theme and decoration plan with DIY instructions
32    """
33    try:
34        theme_agent = Agent(
35            system_prompt=THEME_SPECIALIST_PROMPT
36        )
37        
38        response = theme_agent(party_details)
39        return str(response)
40    except Exception as e:
41        return f"Error in theme & decoration planning: {str(e)}"

1from strands import Agent, tool
2
3ACTIVITY_SPECIALIST_PROMPT = """
4You are an Activity & Entertainment Specialist for home parties in the US. Focus on:
5- Activity suggestions based on duration and group size
6- Entertainment ideas for different age groups
7- Games requiring minimal setup and common items
8
9Provide engaging, easy-to-execute entertainment ideas with clear instructions and material lists.
10"""
11
12
13@tool
14def activity_entertainment_specialist(party_details: str) -> str:
15    """
16    Handle activity and entertainment planning for home parties.
17
18    Args:
19        party_details: Detailed party information including guest ages, duration, etc.
20
21    Returns:
22        Comprehensive activity and entertainment plan with setup instructions
23    """
24    try:
25        activity_agent = Agent(system_prompt=ACTIVITY_SPECIALIST_PROMPT)
26
27        response = activity_agent(party_details)
28        return str(response)
29    except Exception as e:
30        return f"Error in activity & entertainment planning: {str(e)}"

1git clone https://github.com/asakohayase/ai-party-planner.git
2cd ai-party-planner

1AWS_ACCESS_KEY_ID=your_aws_access_key
2AWS_SECRET_ACCESS_KEY=your_aws_secret_key

1cd backend
2uv install

1cd ../frontend
2npm install

1NEXT_PUBLIC_API_URL=http://localhost:8000

1cd backend
2uv run uvicorn app:app --reload --port 8000

1cd frontend
2npm run dev