> ## Documentation Index > Fetch the complete documentation index at: https://docs.snowleopard.ai/llms.txt > Use this file to discover all available pages before exploring further. # Game Club Planner (CrewAI) > Build a multi-agent system that researches games and plans discussion club meetings. A multi-agent system that helps plan game discussion club meetings by researching game data. Built with [CrewAI](https://www.crewai.com/) for agent orchestration. ## What it does This crew of AI agents works together to plan game club meetings. The system: * Researches games using a Metacritic dataset via Snow Leopard * Analyzes game scores, platforms, and release dates * Generates a formatted report with meeting recommendations The crew consists of two agents that collaborate sequentially: 1. **Researcher** - Queries the game database to find relevant titles 2. **Reporting Analyst** - Compiles findings into a formatted report ``` ╭─────────────────────────────────────────────────────────────────────────── Crew Execution Started ───────────────────────────────────────────────────────────────────────────╮ │ │ │ Crew Execution Started │ │ Name: crew │ │ ID: 42f359a6-4cf6-44e2-962a-b737584d4e87 │ │ Tool Args: │ │ │ │ │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ 🚀 Crew: crew └── 📋 Task: research_task (ID: 03ed5bf3-0486-4c3f-a2c3-a34fc57d125c) Status: Executing Task... ╭────────────────────────────────────────────────────────────────────────────── 🤖 Agent Started ──────────────────────────────────────────────────────────────────────────────╮ │ │ │ Agent: Game Researcher for theme: games released between 2010 and 2015 with a metascore above 90 │ │ │ │ Task: Use available tools to find games relevant to this theme: games released between 2010 and 2015 with a metascore above 90 │ │ │ │ │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ 🚀 Crew: crew └── 📋 Task: research_task (ID: 03ed5bf3-0486-4c3f-a2c3-a34fc57d125c) Status: Executing Task... ├── 🔧 Used Snow Leopard Metacritic Data (1) └── 🧠 Thinking... ╭────────────────────────────────────────────────────────────────────────── 🔧 Agent Tool Execution ───────────────────────────────────────────────────────────────────────────╮ │ │ │ Agent: Game Researcher for theme: games released between 2010 and 2015 with a metascore above 90 │ │ │ │ Thought: Thought: I need to query the Snow Leopard Metacritic Data tool to find a list of games released between 2010 and 2015 that have a Metascore above 90. │ │ │ │ Using Tool: Snow Leopard Metacritic Data │ │ │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ ╭───────────────────────────────────────────────────────────────────────────────── Tool Input ─────────────────────────────────────────────────────────────────────────────────╮ │ │ │ { │ │ "question": "List games released between 2010 and 2015 with a Metascore above 90." │ │ } │ │ │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ ╭──────────────────────────────────────────────────────────────────────────────── Tool Output ─────────────────────────────────────────────────────────────────────────────────╮ │ │ │ [{"name": "Super Mario Galaxy 2", "console": "WII", "date": "2010-05-23", "metascore_percent": 97}, {"name": "Grand Theft Auto V", "console": "PS3", "date": "2013-09-17", │ │ "metascore_percent": 97}, {"name": "Grand Theft Auto V", "console": "X360", "date": "2013-09-17", "metascore_percent": 97}, {"name": "Grand Theft Auto V", "console": │ │ "XONE", "date": "2014-11-18", "metascore_percent": 97}, {"name": "Grand Theft Auto V", "console": "PS4", "date": "2014-11-18", "metascore_percent": 97}, {"name": "Mass │ │ Effect 2", "console": "X360", "date": "2010-01-26", "metascore_percent": 96}, {"name": "Batman: Arkham City", "console": "PS3", "date": "2011-10-18", "metascore_percent": │ │ 96}, {"name": "The Elder Scrolls V: Skyrim", "console": "X360", "date": "2011-11-11", "metascore_percent": 96}, {"name": "Grand Theft Auto V", "console": "PC", "date": │ │ "2015-04-14", "metascore_percent": 96}, {"name": "Red Dead Redemption", "console": "PS3", "date": "2010-05-18", "metascore_percent": 95}, {"name": "Red Dead Redemption", │ │ "console": "X360", "date": "2010-05-18", "metascore_percent": 95}, {"name": "Portal 2", "console": "PC", "date": "2011-04-18", "metascore_percent": 95}, {"name": "Portal │ │ 2", "console": "X360", "date": "2011-04-19", "metascore_percent": 95}, {"name": "Portal 2", "console": "PS3", "date": "2011-04-19", "metascore_percent": 95}, {"name": │ │ "The Last of Us", "console": "PS3", "date": "2013-06-14", "metascore_percent": 95}, {"name": "The Last of Us Remastered", "console": "PS4", "date": "2014-07-29", │ │ "metascore_percent": 95}, {"name": "Metal Gear Solid V: The Phantom Pain", "console": "XONE", "date": "2015-09-01", "metascore_percent": 95}, {"name": "Mass Effect 2", │ │ "console": "PC", "date": "2010-01-26", "metascore_percent": 94}, {"name": "Mass Effect 2", "console": "PS3", "date": "2011-01-17", "metascore_percent": 94}, {"name": "The │ │ Legend of Zelda: Ocarina of Time 3D", "console": "3DS", "date": "2011-06-19", "metascore_percent": 94}, {"name": "Batman: Arkham City", "console"... │ │ │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ ╭─────────────────────────────────────────────────────────────────────────── ✅ Agent Final Answer ────────────────────────────────────────────────────────────────────────────╮ │ │ │ Agent: Game Researcher for theme: games released between 2010 and 2015 with a metascore above 90 │ │ │ │ Final Answer: │ │ Here's a list of the top 10 games released between 2010 and 2015 with a Metascore above 90: │ │ │ │ 1. **Super Mario Galaxy 2** │ │ - Console: Wii │ │ - Release Date: 2010-05-23 │ │ - Metascore: 97 │ │ │ │ 2. **Grand Theft Auto V** │ │ - Console: PS3 │ │ - Release Date: 2013-09-17 │ │ - Metascore: 97 │ │ │ │ 3. **Mass Effect 2** │ │ - Console: Xbox 360 │ │ - Release Date: 2010-01-26 │ │ - Metascore: 96 │ │ │ │ 4. **Batman: Arkham City** │ │ - Console: PS3 │ │ - Release Date: 2011-10-18 │ │ - Metascore: 96 │ │ │ │ 5. **The Elder Scrolls V: Skyrim** │ │ - Console: Xbox 360 │ │ - Release Date: 2011-11-11 │ │ - Metascore: 96 │ │ │ │ 6. **Red Dead Redemption** │ │ - Console: PS3 │ │ - Release Date: 2010-05-18 │ │ - Metascore: 95 │ │ │ │ 7. **Portal 2** │ │ - Console: PC │ │ - Release Date: 2011-04-18 │ │ - Metascore: 95 │ │ │ │ 8. **The Last of Us** │ │ - Console: PS3 │ │ - Release Date: 2013-06-14 │ │ - Metascore: 95 │ │ │ │ 9. **The Witcher 3: Wild Hunt** │ │ - Console: PC │ │ - Release Date: 2015-05-18 │ │ - Metascore: 93 │ │ │ │ 10. **Bloodborne** │ │ - Console: PS4 │ │ - Release Date: 2015-03-24 │ │ - Metascore: 92 │ │ │ │ This list includes classics and fan favorites, making it excellent for discussion in a gaming club! │ │ │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ 🚀 Crew: crew └── 📋 Task: research_task (ID: 03ed5bf3-0486-4c3f-a2c3-a34fc57d125c) Assigned to: Game Researcher for theme: games released between 2010 and 2015 with a metascore above 90 Status: ✅ Completed └── 🔧 Used Snow Leopard Metacritic Data (1) ╭────────────────────────────────────────────────────────────────────────────── Task Completion ───────────────────────────────────────────────────────────────────────────────╮ │ │ │ Task Completed │ │ Name: research_task │ │ Agent: Game Researcher for theme: games released between 2010 and 2015 with a metascore above 90 │ │ │ │ Tool Args: │ │ │ │ │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ 🚀 Crew: crew ├── 📋 Task: research_task (ID: 03ed5bf3-0486-4c3f-a2c3-a34fc57d125c) │ Assigned to: Game Researcher for theme: games released between 2010 and 2015 with a metascore above 90 │ │ Status: ✅ Completed │ └── 🔧 Used Snow Leopard Metacritic Data (1) └── 📋 Task: reporting_task (ID: 910aee6e-5479-4d86-bafe-8518486b74bf) Status: Executing Task... ╭────────────────────────────────────────────────────────────────────────────── 🤖 Agent Started ──────────────────────────────────────────────────────────────────────────────╮ │ │ │ Agent: Game Club Planner for theme: games released between 2010 and 2015 with a metascore above 90 │ │ │ │ Task: Use the context you got to make a plan for a game discussion club that plays one game a month revolving around a theme. The theme for the next few months is: games │ │ released between 2010 and 2015 with a metascore above 90 │ │ │ │ │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ 🚀 Crew: crew ├── 📋 Task: research_task (ID: 03ed5bf3-0486-4c3f-a2c3-a34fc57d125c) │ Assigned to: Game Researcher for theme: games released between 2010 and 2015 with a metascore above 90 │ │ Status: ✅ Completed │ └── 🔧 Used Snow Leopard Metacritic Data (1) └── 📋 Task: reporting_task (ID: 910aee6e-5479-4d86-bafe-8518486b74bf) Status: Executing Task... ╭─────────────────────────────────────────────────────────────────────────── ✅ Agent Final Answer ────────────────────────────────────────────────────────────────────────────╮ │ │ │ Agent: Game Club Planner for theme: games released between 2010 and 2015 with a metascore above 90 │ │ │ │ Final Answer: │ │ ### Game Discussion Club Schedule: Games Released Between 2010 and 2015 with a Metascore Above 90 │ │ │ │ #### Month 1: **Super Mario Galaxy 2** │ │ - **Console**: Wii │ │ - **Release Date**: 2010-05-23 │ │ - **Metascore**: 97 │ │ - **Discussion Points**: │ │ - How did the game improve upon the already highly-acclaimed original Super Mario Galaxy? │ │ - What makes the level design stand out even today? │ │ - Discuss the impact of this game on platformers. │ │ │ │ #### Month 2: **Mass Effect 2** │ │ - **Console**: Xbox 360 │ │ - **Release Date**: 2010-01-26 │ │ - **Metascore**: 96 │ │ - **Discussion Points**: │ │ - Narrative depth: How does the game deliver emotional resonance through character stories? │ │ - Discuss the morality system and its influence on the gaming industry. │ │ - Favorite companions and their backstories. │ │ │ │ #### Month 3: **Red Dead Redemption** │ │ - **Console**: PS3 │ │ - **Release Date**: 2010-05-18 │ │ - **Metascore**: 95 │ │ - **Discussion Points**: │ │ - Exploration of the open-world wild west setting. │ │ - Discuss John Marston as a complex protagonist. │ │ - How does the game balance freedom and story-driven progression? │ │ │ │ #### Month 4: **Portal 2** │ │ - **Console**: PC │ │ - **Release Date**: 2011-04-18 │ │ - **Metascore**: 95 │ │ - **Discussion Points**: │ │ - The evolution of puzzles from the first game. │ │ - The game’s humor and writing, especially dialogue from GLaDOS and Wheatley. │ │ - Discuss co-op mode and its impact on the overall experience. │ │ │ │ #### Month 5: **The Elder Scrolls V: Skyrim** │ │ - **Console**: Xbox 360 │ │ - **Release Date**: 2011-11-11 │ │ - **Metascore**: 96 │ │ - **Discussion Points**: │ │ - What makes this game so enduring and deserving of its legendary status? │ │ - Discuss freedom of role-playing and character building. │ │ - Memorable quests, mods, and their contribution to the Skyrim experience. │ │ │ │ #### Month 6: **The Last of Us** │ │ - **Console**: PS3 │ │ - **Release Date**: 2013-06-14 │ │ - **Metascore**: 95 │ │ - **Discussion Points**: │ │ - How does the game create emotional impact through its story and characters? │ │ - The interplay between survival mechanics and narrative design. │ │ - Discuss the relationship between Joel and Ellie. │ │ │ │ #### Month 7: **Grand Theft Auto V** │ │ - **Console**: PS3 │ │ - **Release Date**: 2013-09-17 │ │ - **Metascore**: 97 │ │ - **Discussion Points**: │ │ - Exploration of three-protagonist storytelling. │ │ - How does the game parody contemporary American society? │ │ - Discuss standout moments, missions, and the online experience. │ │ │ │ #### Month 8: **Bloodborne** │ │ - **Console**: PS4 │ │ - **Release Date**: 2015-03-24 │ │ - **Metascore**: 92 │ │ - **Discussion Points**: │ │ - The atmosphere and lore of the gothic, Lovecraftian setting. │ │ - Combat mechanics and how they differ from Soulsborne games. │ │ - Challenges and memorable boss fights. │ │ │ │ #### Month 9: **The Witcher 3: Wild Hunt** │ │ - **Console**: PC │ │ - **Release Date**: 2015-05-18 │ │ - **Metascore**: 93 │ │ - **Discussion Points**: │ │ - Discuss the depth of side quests and their importance to the world-building. │ │ - How Geralt’s moral choices affect the narrative. │ │ - Favorite expansions, characters, and moments. │ │ │ │ #### Month 10: **Batman: Arkham City** │ │ - **Console**: PS3 │ │ - **Release Date**: 2011-10-18 │ │ - **Metascore**: 96 │ │ - **Discussion Points**: │ │ - How does the game improve on the original Arkham Asylum? │ │ - Discuss the open-world design and its influence on superhero games. │ │ - Favorite villains and boss fights. │ │ │ │ This schedule ensures a variety of genres and gameplay experiences spread across ten months, generating engaging discussion topics and a rich exploration of some of │ │ gaming's best titles. │ │ │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ ✅ Crew: crew ├── 📋 Task: research_task (ID: 03ed5bf3-0486-4c3f-a2c3-a34fc57d125c) │ Assigned to: Game Researcher for theme: games released between 2010 and 2015 with a metascore above 90 │ │ Status: ✅ Completed │ └── 🔧 Used Snow Leopard Metacritic Data (1) └── 📋 Task: reporting_task (ID: 910aee6e-5479-4d86-bafe-8518486b74bf) Assigned to: Game Club Planner for theme: games released between 2010 and 2015 with a metascore above 90 Status: ✅ Completed ╭────────────────────────────────────────────────────────────────────────────── Crew Completion ───────────────────────────────────────────────────────────────────────────────╮ │ │ │ Crew Execution Completed │ │ Name: crew │ │ ID: 42f359a6-4cf6-44e2-962a-b737584d4e87 │ │ Tool Args: │ │ Final Output: ### Game Discussion Club Schedule: Games Released Between 2010 and 2015 with a Metascore Above 90 │ │ │ │ #### Month 1: **Super Mario Galaxy 2** │ │ - **Console**: Wii │ │ - **Release Date**: 2010-05-23 │ │ - **Metascore**: 97 │ │ - **Discussion Points**: │ │ - How did the game improve upon the already highly-acclaimed original Super Mario Galaxy? │ │ - What makes the level design stand out even today? │ │ - Discuss the impact of this game on platformers. │ │ │ │ #### Month 2: **Mass Effect 2** │ │ - **Console**: Xbox 360 │ │ - **Release Date**: 2010-01-26 │ │ - **Metascore**: 96 │ │ - **Discussion Points**: │ │ - Narrative depth: How does the game deliver emotional resonance through character stories? │ │ - Discuss the morality system and its influence on the gaming industry. │ │ - Favorite companions and their backstories. │ │ │ │ #### Month 3: **Red Dead Redemption** │ │ - **Console**: PS3 │ │ - **Release Date**: 2010-05-18 │ │ - **Metascore**: 95 │ │ - **Discussion Points**: │ │ - Exploration of the open-world wild west setting. │ │ - Discuss John Marston as a complex protagonist. │ │ - How does the game balance freedom and story-driven progression? │ │ │ │ #### Month 4: **Portal 2** │ │ - **Console**: PC │ │ - **Release Date**: 2011-04-18 │ │ - **Metascore**: 95 │ │ - **Discussion Points**: │ │ - The evolution of puzzles from the first game. │ │ - The game’s humor and writing, especially dialogue from GLaDOS and Wheatley. │ │ - Discuss co-op mode and its impact on the overall experience. │ │ │ │ #### Month 5: **The Elder Scrolls V: Skyrim** │ │ - **Console**: Xbox 360 │ │ - **Release Date**: 2011-11-11 │ │ - **Metascore**: 96 │ │ - **Discussion Points**: │ │ - What makes this game so enduring and deserving of its legendary status? │ │ - Discuss freedom of role-playing and character building. │ │ - Memorable quests, mods, and their contribution to the Skyrim experience. │ │ │ │ #### Month 6: **The Last of Us** │ │ - **Console**: PS3 │ │ - **Release Date**: 2013-06-14 │ │ - **Metascore**: 95 │ │ - **Discussion Points**: │ │ - How does the game create emotional impact through its story and characters? │ │ - The interplay between survival mechanics and narrative design. │ │ - Discuss the relationship between Joel and Ellie. │ │ │ │ #### Month 7: **Grand Theft Auto V** │ │ - **Console**: PS3 │ │ - **Release Date**: 2013-09-17 │ │ - **Metascore**: 97 │ │ - **Discussion Points**: │ │ - Exploration of three-protagonist storytelling. │ │ - How does the game parody contemporary American society? │ │ - Discuss standout moments, missions, and the online experience. │ │ │ │ #### Month 8: **Bloodborne** │ │ - **Console**: PS4 │ │ - **Release Date**: 2015-03-24 │ │ - **Metascore**: 92 │ │ - **Discussion Points**: │ │ - The atmosphere and lore of the gothic, Lovecraftian setting. │ │ - Combat mechanics and how they differ from Soulsborne games. │ │ - Challenges and memorable boss fights. │ │ │ │ #### Month 9: **The Witcher 3: Wild Hunt** │ │ - **Console**: PC │ │ - **Release Date**: 2015-05-18 │ │ - **Metascore**: 93 │ │ - **Discussion Points**: │ │ - Discuss the depth of side quests and their importance to the world-building. │ │ - How Geralt’s moral choices affect the narrative. │ │ - Favorite expansions, characters, and moments. │ │ │ │ #### Month 10: **Batman: Arkham City** │ │ - **Console**: PS3 │ │ - **Release Date**: 2011-10-18 │ │ - **Metascore**: 96 │ │ - **Discussion Points**: │ │ - How does the game improve on the original Arkham Asylum? │ │ - Discuss the open-world design and its influence on superhero games. │ │ - Favorite villains and boss fights. │ │ │ │ This schedule ensures a variety of genres and gameplay experiences spread across ten months, generating engaging discussion topics and a rich exploration of some of │ │ gaming's best titles. │ │ │ │ │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ ``` ## Architecture The application uses CrewAI's multi-agent framework: ### Agents * **Researcher agent** - Has access to the Snow Leopard tool to query game metadata (titles, platforms, metascores, user scores, release dates) * **Reporting analyst agent** - Takes research findings and creates structured reports ### Snow Leopard tool A custom CrewAI tool that wraps the Snow Leopard client: ```python theme={null} class SnowLeopardMetacriticTool(BaseTool): name: str = "Snow Leopard Metacritic Data" description: str = ( "Takes a natural language question and returns game data " "including metascores, platforms, user scores, and release dates." ) def _run(self, question: str) -> str: sl_client = SnowLeopardClient() response = sl_client.retrieve(user_query=question, datafile_id=datafile_id) return json.dumps(response.data[0].rows) ``` ### Workflow The crew runs sequentially: 1. Research task queries game data based on the meeting topic 2. Reporting task compiles results into `report.md` ## Run the example ### Prerequisites * Python 3.10+ * [uv](https://docs.astral.sh/uv/) package manager * OpenAI API key * [Snow Leopard API key](https://auth.snowleopard.ai/account/api_keys) ### Setup Clone the [repository](https://github.com/SnowLeopard-AI/snowy-examples/tree/main/agent_examples/gameclub_crewai): ```bash theme={null} git clone https://github.com/SnowLeopard-AI/snowy-examples.git cd snowy-examples/agent_examples/gameclub_crewai ``` Download and prepare the dataset: 1. Download the Metacritic dataset from [Kaggle](https://www.kaggle.com/datasets/destring/metacritic-reviewed-games-since-2000) (get the `.csv` version) 2. Convert to SQLite: ```bash theme={null} uv run scripts/preparedata.py result.csv metacritic.sqlite ``` 3. Upload `metacritic.sqlite` to [Snow Leopard Playground](https://try.snowleopard.ai) Create a `.env` file: ```bash theme={null} OPENAI_API_KEY=your-openai-key SNOWLEOPARD_API_KEY=your-snowleopard-key SNOWLEOPARD_DATAFILE_ID=your-datafile-id ``` Run the crew: ```bash theme={null} uv run gameclub ``` The crew will research games and output a report to `report.md`. ## Next steps * View the [full source code on GitHub](https://github.com/SnowLeopard-AI/snowy-examples/tree/main/agent_examples/gameclub_crewai) * Learn more about [CrewAI](https://docs.crewai.com/)