subba5076/Berlin_roomates

🏠 Berlin Roommates – Weekend Party AI Agent

An AI agent designed for four roommates living together in Berlin — Srikanth, Nitish, Subrahmanya, and Rahul — to plan weekend parties effortlessly.
This agent uses multiple tools to automate party planning, music selection, menu suggestions, cleaning rotation, budgeting, and more.

---

🎯 Features

✔ Smart Menu Suggestions

• Suggests one Indian chicken dish (casual or formal).
• Casual = when only the 4 roommates are present
• Formal = when guests visit

✔ Theme Generator (Indian Movies / Series)

Generates party themes inspired by:

• KGF
• RRR
• YJHD
• Gangs of Wasseypur
  …and more.

✔ Playlist Generator

• If a theme is recognized → returns a curated playlist
• If not → automatically falls back to WebSearchTool to fetch real songs online

✔ Shopping List Generator

Creates a shopping list based on the selected menu type.

✔ Cleaning Duty Rotation

Randomly assigns cleaning duty to one of the 4 roommates.

✔ Cooking Rotation

Randomly selects who cooks today.

✔ Budget Splitter

Splits total party cost equally among the 4 roommates.

---

🛠 Tools Included

• suggest_menu
• catering_service_tool
• indian_movie_theme_generator
• playlist_tool
• smart_playlist_resolver (fallback to web search)
• shopping_list_tool
• cleaning_rotation_tool
• cooking_rotation_tool
• budget_tool
• WebSearchTool
• VisitWebpageTool

---

🚀 Example Usage

agent.run("Plan a weekend party for us with theme, food, songs, cleaning duty, and budget split.")

📦 How to Use Locally

pip install smolagents huggingface_hub

from smolagents import CodeAgent
from huggingface_hub import snapshot_download

snapshot_download("subba5076/Berlin_roomates")

📄 License This project is released under the MIT License, allowing free use, modification, and sharing.

👤 Author Created by Subramanya Berlin, Germany

---