| description='''# 🤖 **AI Agents Suite: A Multi-Agent System for Content and Game Generation** | |
| ## ✨ **Project Overview** | |
| The **AI Agents Suite** is a collection of intelligent agents designed to automate content generation, game development, and marketing content creation using advanced language models. This system utilizes **CrewAI**, **Gemini LLMs**, and **Serper API** to perform structured, high-quality content generation and game-building tasks. | |
| ## 📃 **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 (Future Integration)** | |
| - Will create **engaging marketing content** tailored for different domains. | |
| - Enables structured **campaign planning** for digital outreach. | |
| --- | |
| ## 🚀 **How the Application Works** | |
| The system is structured into **three 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**. | |
| --- | |
| ### 👩💻 **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. | |
| --- | |
| ## 📅 **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**. | |
| --- | |
| ## 📈 **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. | |
| - **Scalability**: Supports multiple AI models and frameworks. | |
| - **Future Expansion**: New AI-powered agents can be integrated for additional tasks. | |
| --- | |
| ## 🏆 **Future Enhancements** | |
| - **Marketing Post Generator** for social media campaigns. | |
| - **Integration with Cloud-Based AI models** for enhanced scalability. | |
| - **Support for additional Game Development tools** beyond Python. | |
| ### 📚 **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. | |
| """ | |
| footer = """ | |
| <div style="background-color: #1d2938; color: white; padding: 10px; width: 100%; bottom: 0; left: 0; display: flex; justify-content: space-between; align-items: center; padding: .2rem 35px; box-sizing: border-box; font-size: 16px;"> | |
| <div style="text-align: left;"> | |
| <p style="margin: 0;">© 2025 </p> | |
| </div> | |
| <div style="text-align: center; flex-grow: 1;"> | |
| <p style="margin: 0;"> This website is made with ❤ by SARATH CHANDRA</p> | |
| </div> | |
| <div class="social-links" style="display: flex; gap: 20px; justify-content: flex-end; align-items: center;"> | |
| <a href="https://github.com/21bq1a4210" target="_blank" style="text-align: center;"> | |
| <img src="data:image/png;base64,{}" alt="GitHub" width="40" height="40" style="display: block; margin: 0 auto;"> | |
| <span style="font-size: 14px;">GitHub</span> | |
| </a> | |
| <a href="https://www.linkedin.com/in/sarath-chandra-bandreddi-07393b1aa/" target="_blank" style="text-align: center;"> | |
| <img src="data:image/png;base64,{}" alt="LinkedIn" width="40" height="40" style="display: block; margin: 0 auto;"> | |
| <span style="font-size: 14px;">LinkedIn</span> | |
| </a> | |
| <a href="https://21bq1a4210.github.io/MyPortfolio-/" target="_blank" style="text-align: center;"> | |
| <img src="data:image/png;base64,{}" alt="Portfolio" width="40" height="40" style="display: block; margin-right: 40px;"> | |
| <span style="font-size: 14px;">Portfolio</span> | |
| </a> | |
| </div> | |
| </div> | |
| """ |