description = ''' # 🤖 **AI Agents Suite: A Multi-Agent System for Content, Game, Marketing, and Travel Planning** ## ✨ **Project Overview** The **AI Agents Suite** is a collection of intelligent agents designed to automate content generation, game development, marketing content creation, and travel planning using advanced language models. This system utilizes **CrewAI**, **Gemini LLMs**, and **Serper API** to perform structured, high-quality content generation, game-building, marketing tasks, and travel itineraries. ## 📃 **Key Components** ### 1. **SEO Content Generator Agent** - Generates **SEO-optimized articles** by researching topics and crafting high-quality content. - Supports **online research** using **Serper API** for real-time data collection. - Leverages **Gemini AI models** for efficient content writing. ### 2. **Game Development Agent** - Automates the process of **designing and developing games** using Python. - Ensures **code quality** by integrating multiple levels of **quality control** through AI agents. - Supports **multiple game genres**, including classic arcade, board games, and more. ### 3. **Marketing Post Generator Agent** - Creates **engaging marketing content** tailored for different domains. - Enables structured **campaign planning** for digital outreach. - Leverages **Gemini AI models** for innovative and impactful post creation. ### 4. **Trip Planner Agent** - Automates the creation of **personalized travel itineraries**. - Utilizes various tools to gather information, select the best city, and generate a comprehensive travel plan. - Ensures high-quality, personalized travel itineraries with detailed per-day plans, including weather forecasts, places to eat, packing suggestions, and a budget breakdown. --- ## 🚀 **How the Application Works** The system is structured into **four main AI-driven agents** that interact through the **CrewAI** framework: ### 🌟 **1. SEO Content Generator Agent** - Accepts a **topic** input from the user. - Performs **online research** if enabled. - Generates a **structured, SEO-optimized article**. #### **Workflow:** 1. **User Inputs** topic and selects an **AI model**. 2. AI **Research Agent** gathers insights from online sources (if enabled). 3. AI **Content Writer Agent** drafts a **polished article**. 4. Outputs a **ready-to-publish** SEO article. --- ### 🌟 **2. Game Development Agent** - Converts **game design instructions** into fully functional **Python game code**. - Implements **multi-step quality control** using dedicated agents. - Generates **error-free, optimized game logic**. #### **Workflow:** 1. User provides **game design instructions**. 2. **Senior Game Developer Agent** writes game logic. 3. **QA Engineer Agent** inspects code for errors. 4. **Chief QA Engineer Agent** ensures **game functionality**. 5. Outputs **fully functional game code**. --- ### 📢 **3. Marketing Post Generator Agent** - Creates **compelling marketing posts** for social media campaigns. - Conducts **market research** to tailor content to the target audience. - Ensures posts are **aligned with marketing strategies**. #### **Workflow:** 1. User provides **campaign details** and selects an **AI model**. 2. **Market Research Analyst Agent** gathers insights on the target audience and competitors. 3. **Creative Content Writer Agent** drafts engaging marketing posts. 4. **Social Media Strategist Agent** ensures posts are optimized for engagement. 5. Outputs a set of **polished marketing posts**. --- ### 🌟 **4. Trip Planner Agent** - Automates the creation of **personalized travel itineraries**. - Utilizes various tools to gather information, select the best city, and generate a comprehensive travel plan. - Ensures high-quality, personalized travel itineraries with detailed per-day plans, including weather forecasts, places to eat, packing suggestions, and a budget breakdown. #### **Workflow:** 1. User provides **trip details** and selects an **AI model**. 2. **City Selection Expert Agent** analyzes and selects the best city for the trip. 3. **Local Expert Agent** compiles an in-depth guide about the selected city. 4. **Travel Concierge Agent** develops a full 7-day travel itinerary with detailed per-day plans. 5. Outputs a **comprehensive travel plan** and detailed logs. --- ### 👩💻 **Agents in Action** #### **SEO Content Generator Agents** - **Researcher Agent**: Collects data for SEO optimization. - **Content Writer Agent**: Creates structured articles based on research. #### **Game Development Agents** - **Senior Game Developer**: Writes Python game code based on input instructions. - **QA Engineer**: Identifies syntax errors, missing imports, and logic issues. - **Chief QA Engineer**: Ensures the game works correctly and optimally. #### **Marketing Post Generator Agents** - **Market Research Analyst**: Gathers insights on the target audience and competitors. - **Creative Content Writer**: Crafts engaging marketing posts. - **Social Media Strategist**: Ensures posts are aligned with marketing strategies and optimized for engagement. #### **Trip Planner Agents** - **City Selection Expert**: Analyzes travel data to select the best city based on weather, season, and prices. - **Local Expert**: Provides in-depth insights about the selected city, including attractions and local customs. - **Travel Concierge**: Creates detailed travel itineraries with budget and packing suggestions. --- ## 📅 **Usage Instructions** ### 🌐 **SEO Content Generator** 1. Select **AI Model** (e.g., Gemini Flash, Gemini Pro). 2. Enter **Gemini API Key**. 3. Choose **Online Search** (Yes/No). 4. Provide a **topic**. 5. Click **Generate Content**. ### 🎮 **Game Development Agent** 1. Select **AI Model**. 2. Enter **Game Instructions**. 3. Click **Generate Game Code**. ### 📢 **Marketing Post Generator** 1. Select **AI Model**. 2. Enter **Campaign Details**. 3. Click **Generate Marketing Posts**. ### 🌍 **Trip Planner Agent** 1. Select **AI Model**. 2. Enter **Trip Details**. 3. Click **Generate Travel Plan**. --- ## 📈 **Supported AI Models** ### **Gemini Models** - **Gemini-1.5-Flash** (Fastest Response) - **Gemini-1.5-Pro** (Balanced Performance) - **Gemini-Pro** (Most Accurate) --- ## 📄 **Project Benefits** - **Automated Content Generation**: Saves time by generating high-quality SEO articles. - **Efficient Game Development**: Automates coding and quality checks for Python games. - **Engaging Marketing Content**: Creates impactful marketing posts tailored to the target audience. - **Personalized Travel Planning**: Automates the creation of personalized travel itineraries. - **Scalability**: Supports multiple AI models and frameworks. - **Future Expansion**: New AI-powered agents can be integrated for additional tasks. --- ## 🏆 **Future Enhancements** - **Integration with Cloud-Based AI models** for enhanced scalability. - **Support for additional Game Development tools** beyond Python. - **Advanced Marketing Analytics** for better campaign performance tracking. - **Real-Time Updates** for weather, events, and travel advisories in travel planning. ### 📚 **Get Started Today!** Explore the power of AI-driven automation and enhance your workflow with the **AI Agents Suite**! ''' gemini_api_key = """ ** STEP by STEP Guide for getting Gemini API key **: This is the fastest and easiest method. 1. **Go to Google AI Studio:** Open your web browser and navigate to the Google AI Studio website: [https://makersuite.google.com/](https://makersuite.google.com/) 2. **Sign in with your Google Account:** You'll need a Google account (Gmail, Google Workspace, etc.) to access Google AI Studio. If you're not already signed in, click the "Sign in" button (usually in the top-right corner) and follow the prompts to log in. 3. **Create a New Project (if necessary):** * If you're presented with a welcome screen or a list of existing projects, look for a button like "Create new" or "+ New Project" (the exact wording may vary slightly). Click it. If you're taken directly to a blank prompt area, you're already in a project. * You might be prompted to name your project. Give it a descriptive name (e.g., "Gemini API Test"). 4. **Get Your API Key:** * In the Google AI Studio interface, look for a button or link that says "Get API key" or similar. It's often located: * In the left-hand sidebar. * At the top of the page, near your profile icon. * Within a "Settings" or "API Access" section. * Click the "Get API key" button. 5. **Create Key in new project or select an existing one** * Select the Create API key in new project. * If you have existing project then select the Create API key in existing project. 6. **Copy Your API Key:** * A pop-up window or a new section will appear, displaying your API key. It will be a long string of letters and numbers. * Click the "Copy" button (or manually select and copy the key) to copy it to your clipboard. **Keep this key safe and secret!** Do not share it publicly. 7. **Important Considerations:** * **Free Tier Limits:** Be aware that the Google AI Studio free tier has usage limits (rate limits and possibly daily/monthly quotas). If you exceed these limits, your API calls will be temporarily blocked. The limits are usually generous enough for experimentation. * **Key Security:** Treat your API key like a password. Do *not* hardcode it directly into publicly accessible code (like client-side JavaScript or public GitHub repositories). Use environment variables or secure key management systems in your applications. * **Terms of Service:** By using the Gemini API, you agree to Google's Terms of Service. It's a good idea to review these terms. """ serper_api_key=""" **Step-by-Step Guide to Getting a SERPER API Key** 1. **Go to the SERPER Website:** * Open your web browser and navigate to the SERPER website: [https://serper.dev/](https://serper.dev/) 2. **Sign Up or Log In:** * If you're a new user, click the "Sign Up" or "Get Started for Free" button (the exact wording may vary). You'll likely need to provide an email address and create a password. * If you already have an account, click the "Login" or "Sign In" button and enter your credentials. 3. **Navigate to the Dashboard (or API Keys Section):** * Once you're logged in, you should be taken to your SERPER dashboard. If not, look for a link or button that says "Dashboard," "API Keys," "Account," or similar. The exact location may vary depending on the website's layout. It's almost always in the top-right corner of the screen. 4. **Create a New API Key:** * On the dashboard or API keys page, look for a button or link that says "Create API Key," "Add New Key," "Generate Key," or similar. Click it. * You might be prompted to give your API key a name or description (this is optional but recommended for organization if you plan to use multiple keys). 5. **Copy Your API Key:** * After creating the key, it should be displayed on the screen. It will be a long string of letters and numbers (and possibly other characters). * There will usually be a "Copy" button or icon next to the key. Click it to copy the key to your clipboard. If there isn't a copy button, carefully select the entire key and copy it manually (Ctrl+C or Cmd+C). **Important:** Keep this key secret! Do not share it publicly. 6. **Check the pricing plans** * Serper offfers different types of plans like Hobby, Startup, Growth, Pro and Enterprise. * Check the website [https://serper.dev/](https://serper.dev/) and choose your required plan. 7. **Important Considerations:** * **Free Tier/Trial:** SERPER often offers a free tier or a trial period with a limited number of API calls. Be aware of these limits to avoid unexpected charges or service interruptions. The free tier usually has fairly generous limits for initial testing. * **Pricing:** If you plan to use the API beyond the free tier or trial, make sure you understand SERPER's pricing structure. Pricing is usually based on the number of API requests you make per month. Find the pricing information on their website (usually a "Pricing" link in the navigation). * **Rate Limits:** Even within paid plans, there are usually rate limits (the number of requests you can make per second or per minute). This prevents abuse and ensures fair usage. The documentation will specify these limits. * **API Documentation:** Before using the API, *thoroughly* read the SERPER API documentation: [https://serper.dev/docs](https://serper.dev/docs). This documentation explains how to format your requests, the available parameters, and the structure of the responses you'll receive. It's essential for using the API correctly. * **Security:** Treat your API key like a password. *Never* embed it directly in client-side code (like JavaScript that runs in a web browser) or in public code repositories (like on GitHub). Use environment variables (the preferred method) or a secure key management system to store your API key. * Terms of service : Go through terms of service. By following these steps, you should be able to obtain and start using your SERPER API key. Remember to consult the official documentation for the most up-to-date and detailed information. """ seo_content="""# CrewAI Content Generation Agent ## Overview The provided Agent leverages the CrewAI framework to automate the process of generating SEO-optimized content. It integrates with the Gemini language model and optionally uses the SerperDevTool for online search capabilities. ## Roles - **Online Research Specialist**: Conducts comprehensive research on the specified topic, focusing on SEO recommendations. - **Expert Content Writer**: Creates SEO-optimized content based on the research findings, ensuring high-quality and polished output. ## Tasks - **Research Task**: Aggregates detailed information and SEO recommendations on the given topic. - **Writing Task**: Produces a polished, SEO-optimized article draft ready for publication. ## Usage 1. **Set Model**: Choose the desired Gemini model. 2. **Configure API Keys**: Provide necessary API keys for Gemini and SerperDevTool. 3. **Run Crew**: Execute the crew with the specified topic to generate content. ## Features - **Model Selection**: Supports multiple Gemini language models for flexibility. - **API Configuration**: Manages API keys for Gemini and SerperDevTool. - **Agent Roles**: Defines specialized agents for research and content writing. - **Task Management**: Orchestrates sequential tasks for research and writing. - **Output**: Generates a polished article draft and detailed logs. ## Benefits - **Efficiency**: Automates the content creation process, saving time and effort. - **Quality**: Ensures high-quality, SEO-optimized content. - **Flexibility**: Allows for easy integration of online search tools for enhanced research. Experience streamlined content generation with CrewAI's advanced automation capabilities.""" game_dev = """# CrewAI Game Development Agent ## Overview The provided code utilizes the CrewAI framework to automate the development and quality assurance process for creating games using Python. It leverages the Gemini language model to facilitate the tasks. ## Roles - **Senior Game Developer**: Designs and develops engaging games based on provided instructions. - **Software Quality Control Engineer**: Reviews the code for errors, including syntax, logic, and security vulnerabilities. - **Chief Software Quality Control Engineer**: Ensures the code is complete and functions as intended. ## Tasks - **Code Task**: Develops the game based on the given instructions. - **Review Task**: Checks the code for errors and vulnerabilities. - **Evaluate Task**: Ensures the code is complete and performs the intended functions. ## Usage 1. **Set Model**: Choose the desired Gemini model. 2. **Configure API Keys**: Provide the necessary API key for Gemini. 3. **Run Crew**: Execute the crew with the specified game instructions to generate the game code. ## Features - **Model Selection**: Supports multiple Gemini language models for flexibility. - **API Configuration**: Manages API keys for Gemini. - **Agent Roles**: Defines specialized agents for game development and quality assurance. - **Task Management**: Orchestrates sequential tasks for coding, reviewing, and evaluating. - **Output**: Generates a complete Python game code and detailed logs. ## Benefits - **Efficiency**: Automates the game development process, saving time and effort. - **Quality**: Ensures high-quality, error-free code. - **Flexibility**: Allows for easy integration of additional tools for enhanced functionality. Experience streamlined game development with CrewAI's advanced automation capabilities. """ marking_post_gen_agent = ''' # CrewAI Marketing Post Generator Agent ## Overview The Marketing Post Generator Agent leverages the CrewAI framework to automate the creation of engaging and effective marketing posts for social media campaigns. It integrates with the Gemini language model to ensure high-quality, tailored content. ## Roles - **Market Research Analyst**: Conducts in-depth research on the target audience and competitors to gather insights for post creation. - **Creative Content Writer**: Crafts compelling and innovative marketing posts based on the research findings. - **Social Media Strategist**: Ensures the posts align with the overall marketing strategy and are optimized for engagement. ## Tasks - **Research Task**: Aggregates detailed information on the target audience, competitors, and current market trends. - **Content Creation Task**: Develops engaging and innovative marketing posts tailored to the target audience. - **Strategy Alignment Task**: Ensures the posts are aligned with the overall marketing strategy and optimized for maximum impact. ## Usage 1. **Set Model**: Choose the desired Gemini model. 2. **Configure API Keys**: Provide the necessary API key for Gemini. 3. **Run Crew**: Execute the crew with the specified campaign details to generate marketing posts. ## Features - **Model Selection**: Supports multiple Gemini language models for flexibility. - **API Configuration**: Manages API keys for Gemini. - **Agent Roles**: Defines specialized agents for market research, content creation, and strategy alignment. - **Task Management**: Orchestrates sequential tasks for research, content creation, and strategy alignment. - **Output**: Generates a set of polished marketing posts and detailed logs. ## Benefits - **Efficiency**: Automates the marketing post creation process, saving time and effort. - **Quality**: Ensures high-quality, engaging, and strategically aligned content. - **Flexibility**: Allows for easy integration of additional tools for enhanced functionality. Experience streamlined marketing post generation with CrewAI's advanced automation capabilities. ''' trip_planner_agent = ''' # CrewAI Trip Planner Agent ## Overview The Trip Planner Agent leverages the CrewAI framework to automate the creation of personalized travel itineraries. It integrates with the Gemini language model and utilizes various tools to gather information, select the best city, and generate a comprehensive travel plan. ## Roles - **City Selection Expert**: Analyzes travel data to select the best city based on weather, season, and prices. - **Local Expert**: Provides in-depth insights about the selected city, including attractions and local customs. - **Travel Concierge**: Creates detailed travel itineraries with budget and packing suggestions. ## Tasks - **City Selection Task**: Analyzes and selects the best city for the trip based on specific criteria. - **Information Gathering Task**: Compiles an in-depth guide about the selected city, including key attractions and local customs. - **Itinerary Planning Task**: Develops a full 7-day travel itinerary with detailed per-day plans, including weather forecasts, places to eat, packing suggestions, and a budget breakdown. ## Usage 1. **Set Model**: Choose the desired Gemini model. 2. **Configure API Keys**: Provide the necessary API key for Gemini. 3. **Run Crew**: Execute the crew with the specified trip details to generate the travel plan. ## Features - **Model Selection**: Supports multiple Gemini language models for flexibility. - **API Configuration**: Manages API keys for Gemini. - **Agent Roles**: Defines specialized agents for city selection, local expertise, and travel planning. - **Task Management**: Orchestrates sequential tasks for city selection, information gathering, and itinerary planning. - **Output**: Generates a comprehensive travel plan and detailed logs. ## Benefits - **Efficiency**: Automates the travel planning process, saving time and effort. - **Quality**: Ensures high-quality, personalized travel itineraries. - **Flexibility**: Allows for easy integration of additional tools for enhanced functionality. Experience streamlined travel planning with CrewAI's advanced automation capabilities. ''' footer = """
© 2025
This website is made with ❤ by SARATH CHANDRA