🚀 Welcome to the future of AI collaboration! This project demonstrates how to build powerful multi-agent systems using CrewAI, where AI agents work together like a real team to solve complex problems.
CrewAI is a cutting-edge framework that enables you to orchestrate role-playing, autonomous AI agents. By fostering collaborative intelligence, CrewAI empowers agents to work together seamlessly, tackling complex tasks more effectively than any single AI could alone.
- 🤝 Multi-Agent Collaboration: Agents work together like a real team
- 🎭 Role-Based Agents: Each agent has specific roles and expertise
- 🔄 Sequential Task Execution: Tasks flow logically from one agent to another
- 🛠️ Custom Tools: Extend agents with specialized capabilities
- 📊 Verbose Logging: Track every step of the process
📦 CrewAI-Project/
├── 🐍 main.py # Interactive multi-agent system
├── 🔧 test3agents.py # Advanced 3-agent collaboration
├── 📋 requirements.txt # Python dependencies
├── 📝 Instructions.md # 📋 Detailed setup guide
├── 🙈 .gitignore # Git ignore rules
├── 🌍 .env # Environment variables (create this)
└── 📖 README.md # This file
📋 Detailed Setup Instructions: For a comprehensive step-by-step guide, see our Instructions.md file!
- 🐍 Python 3.11.9 (Required version)
- 🔑 OpenAI API Key (Get one here)
- 💻 Terminal/Command Prompt/Powershell
git clone https://github.com/jishanahmed-shaikh/CrewAI-AgenticAI-Framework.git
cd CrewAI-AgenticAI-FrameworkCreate a .env file in the project root:
OPENAI_API_KEY=your_actual_api_key_here🔐 Security Note: Never commit your API key to version control!
# Create virtual environment
python -m venv crew-env
# Activate it (Windows)
crew-env\Scripts\activate
# Activate it (macOS/Linux)
source crew-env/bin/activatepip install -r requirements.txtPerfect for beginners! This example shows a single Python developer agent:
python main.pyWhat it does:
- 🤖 Creates a Python Developer agent
- 📝 Assigns a task to reverse a string
- ✅ Executes and shows the result
This showcases the real power of CrewAI with 3 specialized agents:
python test3agents.pyMeet the Team:
- 🔧 Technician Agent: Sets up software and environments
- 🛡️ Security Agent: Handles authentication with Keycloak
- 🧪 Testing Agent: Validates everything works perfectly
agent = Agent(
role="Your Agent's Job Title", # 🎭 What they do
goal="What they want to achieve", # 🎯 Their objective
backstory="Their background story", # 📚 Their expertise
verbose=True, # 📢 Show their work
tools=[custom_tools] # 🛠️ Special abilities
)task = Task(
description="What needs to be done", # 📝 The assignment
expected_output="What you expect", # ✅ Success criteria
agent=assigned_agent # 🤖 Who does it
)crew = Crew(
agents=[agent1, agent2, agent3], # 🤖 The team
tasks=[task1, task2, task3], # 📋 The work
verbose=True # 📊 Show progress
)Want to give your agents superpowers? Here's how to create custom tools:
from langchain.tools import BaseTool
from pydantic import BaseModel, Field
class CustomToolInput(BaseModel):
parameter: str = Field(..., description="Tool parameter")
class CustomTool(BaseTool):
name = "ToolName"
description = "What this tool does"
args_schema = CustomToolInput
def _run(self, parameter: str) -> str:
# Your tool logic here
return f"Tool executed with: {parameter}"- 📊 Data Analysis Pipeline: Research → Analysis → Reporting
- 🛒 E-commerce Automation: Product research → Content creation → Marketing
- 📈 Financial Planning: Market analysis → Strategy → Risk assessment
- 🔧 DevOps Pipeline: Setup → Security → Testing (like our example!)
- 📱 App Development: Planning → Coding → Testing → Deployment
- 🐛 Bug Resolution: Detection → Analysis → Fix → Verification
- ✍️ Content Creation: Research → Writing → Editing → Publishing
- 🎬 Video Production: Scripting → Storyboarding → Editing → Review
- 🎵 Music Production: Composition → Arrangement → Mixing → Mastering
📋 Need More Help? Check our comprehensive Instructions.md for detailed troubleshooting steps!
- ✅ Check your
.envfile exists - ✅ Verify the key format:
OPENAI_API_KEY=sk-... - ✅ Restart your terminal after creating
.env
- ✅ Use Python 3.11.9 specifically
- ✅ Check with:
python --version - ✅ Consider using pyenv for version management
- ✅ Activate your virtual environment
- ✅ Run:
pip install -r requirements.txt - ✅ Check you're in the right directory
- "Multi-Agent Systems" by Gerhard Weiss
- "Artificial Intelligence: A Modern Approach" by Russell & Norvig
- "The Alignment Problem" by Brian Christian
We love contributions! Here's how you can help:
- 🍴 Fork the repository
- 🌿 Create a feature branch:
git checkout -b amazing-feature - 💾 Commit your changes:
git commit -m 'Add amazing feature' - 📤 Push to the branch:
git push origin amazing-feature - 🎉 Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- 🎉 CrewAI Team for the amazing framework
- 🤖 OpenAI for the powerful language models
- 🐍 Python Community for the excellent ecosystem
- 👥 Contributors who make this project better
- 💬 Community: Join the CrewAI community
- 🐦 Twitter: @CrewAI
- 📧 Help: Help
- 🐛 Issues: GitHub Issues
Made with ❤️ by the Mr. Jishanahmed AR Shaikh for the AI Community
"The future belongs to organizations that can harness the collective intelligence of AI agents working in harmony."
Ready to build your own AI agent team? Here are some ideas:
- 🎯 Customer Service Crew: Support → Escalation → Resolution
- 📊 Market Research Team: Data collection → Analysis → Insights
- 🎨 Creative Agency: Brainstorming → Design → Review → Refinement
- 🏥 Healthcare Assistant: Symptoms → Diagnosis → Treatment → Follow-up
The possibilities are endless! 🌈
Happy coding! 🎉