Upload 2 files

README.md

@@ -1,13 +1,221 @@
----
-title: Blogs Agent
-emoji: 📚
-colorFrom: red
-colorTo: red
-sdk: gradio
-sdk_version: 5.42.0
-app_file: app.py
-pinned: false
-license: openrail
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Crew Agents - AI-Powered Multi-Agent System
+
+A sophisticated multi-agent system built with CrewAI that demonstrates the power of collaborative AI agents for content creation and email optimization. This project showcases how multiple specialized AI agents can work together to accomplish complex tasks through research, writing, and communication enhancement.
+
+## 🚀 Features
+
+### 🤖 Multi-Agent Architecture
+- **Research Specialist Agent**: Web research and fact-finding capabilities
+- **Creative Writer Agent**: Blog post creation with engaging content
+- **Email Agent**: Email optimization and professional communication enhancement
+
+### 📝 Content Generation
+- **Blog Creation**: Automated research and writing of 250-word blog posts
+- **Fact Research**: Web-based research using SerperDev and website search tools
+- **Structured Content**: Hook, introduction, body, conclusion, and call-to-action format
+
+### 📧 Email Enhancement
+- **Professional Tone**: Converts casual emails to professional communication
+- **Jargon Expansion**: Automatically expands abbreviations (AI, ML, NLP, etc.)
+- **Gen-Z Term Expansion**: Modernizes informal language for professional contexts
+
+## 🛠️ Technology Stack
+
+- **Python 3.12+**: Modern Python with advanced features
+- **CrewAI**: Multi-agent orchestration framework
+- **Gemini 2.0 Flash**: Google's latest AI model for natural language processing
+- **SerperDev**: Web search and research capabilities
+- **Website Search Tool**: RAG-enabled web content analysis
+- **Streamlit**: Web application framework (planned integration)
+
+## 📋 Prerequisites
+
+- Python 3.12 or higher
+- Access to Google Gemini API
+- SerperDev API key for web search functionality
+- Internet connection for web research capabilities
+
+## 🚀 Installation
+
+1. **Clone the repository**
+   ```bash
+   git clone <your-repo-url>
+   cd crew_agents
+   ```
+
+2. **Install dependencies using uv (recommended)**
+   ```bash
+   uv sync
+   ```
+
+   **Alternative: Using pip**
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+3. **Set up environment variables**
+   Create a `.env` file in the root directory:
+   ```env
+   GOOGLE_API_KEY=your_gemini_api_key_here
+   SERPER_API_KEY=your_serperdev_api_key_here
+   ```
+
+## 🔧 Configuration
+
+### API Keys Setup
+- **Google Gemini**: Get your API key from [Google AI Studio](https://makersuite.google.com/app/apikey)
+- **SerperDev**: Sign up at [SerperDev](https://serper.dev/) for web search capabilities
+
+### Model Configuration
+The system uses Gemini 2.0 Flash with the following settings:
+- Temperature: 0.7 (balanced creativity and consistency)
+- Streaming: Enabled for real-time output
+- Context-aware processing
+
+## 📖 Usage Examples
+
+### 1. Blog Generation
+
+#### **Command Line Interface**
+Run the blog generation system:
+
+```bash
+python blogs_agent.py
+```
+
+**Default Topic**: "How Agriculture can be changed by AGI"
+
+**Custom Topic**: Modify line 64 in `blogs_agent.py`:
+```python
+response = crew.kickoff(inputs={"topic": "Your custom topic here"})
+```
+
+#### **Web Interface (Gradio App)**
+Launch the beautiful web interface:
+
+```bash
+python gradio_app.py
+```
+
+**Features**:
+- User-friendly web interface
+- Real-time progress tracking
+- Beautiful markdown output
+- Example topics for inspiration
+- Responsive design
+
+**Access**: Open your browser and go to `http://localhost:7860`
+
+**Output**: A well-researched, 250-word blog post with:
+- Engaging hook
+- Introduction paragraph
+- Body content with researched facts
+- Conclusion
+- Call-to-action
+
+### 2. Email Enhancement
+
+Run the email optimization system:
+
+```bash
+python emailAgent/email_agent.py
+```
+
+**Features**:
+- Professional tone conversion
+- Jargon expansion (AI → Artificial Intelligence)
+- Gen-Z term modernization
+- Enhanced persuasiveness
+
+### 3. Advanced Email Tools
+
+For enhanced email processing with custom tools:
+
+```bash
+python emailAgent/agent_tool.py
+```
+
+**Custom Tools**:
+- Jargon replacement tool
+- Professional language enhancement
+- Context-aware improvements
+
+## 🏗️ Project Structure
+
+```
+crew_agents/
+├── blogs_agent.py          # Main blog generation system (CLI)
+├── gradio_app.py           # Web interface for blog generation
+├── main.py                 # Entry point (placeholder)
+├── pyproject.toml         # Project configuration and dependencies
+├── requirements.txt        # Python dependencies
+├── emailAgent/            # Email enhancement module
+│   ├── email_agent.py     # Basic email optimization
+│   └── agent_tool.py      # Advanced email tools
+├── BlogsAgent/            # Blog-related components (planned)
+├── db/                    # Database storage (Chroma vector DB)
+│   └── chroma.sqlite3     # Vector database file
+└── README.md              # This file
+```
+
+## 🔍 How It Works
+
+### Blog Generation Process
+1. **Research Phase**: Research Specialist Agent searches the web for relevant facts
+2. **Content Creation**: Creative Writer Agent crafts engaging blog content
+3. **Quality Assurance**: Structured format with hook, body, and conclusion
+4. **Output**: Professional blog post ready for publication
+
+### Email Enhancement Process
+1. **Input Analysis**: Raw email content analysis
+2. **Language Processing**: Jargon expansion and tone adjustment
+3. **Professional Refinement**: Enhanced communication style
+4. **Output**: Polished, professional email
+
+## 🎯 Use Cases
+
+- **Content Marketing**: Automated blog creation for websites
+- **Research Papers**: Fact-finding and content generation
+- **Professional Communication**: Email optimization for business
+- **Educational Content**: Research-based learning materials
+- **SEO Content**: Web-optimized articles with current information
+
+## 🚧 Future Enhancements
+
+- [x] Gradio web interface for user interaction ✅
+- [ ] Additional agent types (Editor, SEO Specialist, etc.)
+- [ ] Content scheduling and publishing automation
+- [ ] Multi-language support
+- [ ] Advanced content analytics
+- [ ] Integration with CMS platforms
+- [ ] Email agent web interface
+- [ ] Content export options (PDF, Word, etc.)
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📝 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- [CrewAI](https://github.com/joaomdmoura/crewAI) for the multi-agent framework
+- [Google Gemini](https://ai.google.dev/) for advanced language models
+- [SerperDev](https://serper.dev/) for web search capabilities
+
+## 📞 Support
+
+For questions, issues, or contributions:
+- Open an issue on Gitlab
+- Check the CrewAI documentation
+- Review the project structure and examples
+
+---
+
+**Built with ❤️ using CrewAI and modern AI technologies**

requirements.txt

@@ -0,0 +1,4 @@
+crewai[tools]>=0.159.0
+streamlit>=1.48.1
+gradio>=4.0.0
+python-dotenv>=1.0.0