Merge branch 'main' into update_readme.md

More GH link updates

README.md

@@ -8,7 +8,7 @@
 
 <h3>
 
-[Homepage](https://www.crewai.com/) | [Documentation](https://docs.crewai.com/) | [Chat with Docs](https://chatg.pt/DWjSBZn) | [Examples](https://github.com/crewAIInc/crewAI-examples) | [Discourse](https://community.crewai.com)
+[Homepage](https://www.crewai.com/) | [Documentation](https://docs.crewai.com/) | [Chat with Docs](https://chatg.pt/DWjSBZn) | [Examples](https://github.com/crewAIInc/crewAI-examples) | [Discord](https://discord.com/invite/X4JWnZnxPb)
 
 </h3>
 

docs/core-concepts/Pipeline.md

@@ -32,8 +32,8 @@ Each input creates its own run, flowing through all stages of the pipeline. Mult
 
 ## Pipeline Attributes
 
-| Attribute  | Parameters | Description                                                                                     |
-| :--------- | :--------- | :---------------------------------------------------------------------------------------------- |
+| Attribute  | Parameters | Description                                                                           |
+| :--------- | :--------- | :------------------------------------------------------------------------------------ |
 | **Stages** | `stages`   | A list of crews, lists of crews, or routers representing the stages to be executed in sequence. |
 
 ## Creating a Pipeline
@@ -239,7 +239,7 @@ email_router = Router(
             pipeline=normal_pipeline
         )
     },
-    default=Pipeline(stages=[normal_pipeline])  # Default to just normal if no urgency score
+    default=Pipeline(stages=[normal_pipeline])  # Default to just classification if no urgency score
 )
 
 # Use the router in a main pipeline

docs/core-concepts/Tasks.md

@@ -131,7 +131,6 @@ research_agent = Agent(
   verbose=True
 )
 
-# to perform a semantic search for a specified query from a text's content across the internet
 search_tool = SerperDevTool()
 
 task = Task(
@@ -313,4 +312,4 @@ save_output_task = Task(
 
 ## Conclusion
 
-Tasks are the driving force behind the actions of agents in crewAI. By properly defining tasks and their outcomes, you set the stage for your AI agents to work effectively, either independently or as a collaborative unit. Equipping tasks with appropriate tools, understanding the execution process, and following robust validation practices are crucial for maximizing CrewAI's potential, ensuring agents are effectively prepared for their assignments and that tasks are executed as intended.
+Tasks are the driving force behind the actions of agents in crewAI. By properly defining tasks and their outcomes, you set the stage for your AI agents to work effectively, either independently or as a collaborative unit. Equipping tasks with appropriate tools, understanding the execution process, and following robust validation practices are crucial for maximizing CrewAI's potential, ensuring agents are effectively prepared for their assignments and that tasks are executed as intended.

docs/getting-started/Start-a-New-CrewAI-Project-Template-Method.md

@@ -17,12 +17,40 @@ Before we start, there are a couple of things to note:
 Before getting started with CrewAI, make sure that you have installed it via pip:
 
 ```shell
-$ pip install 'crewai[tools]'
+$ pip install crewai crewai-tools
 ```
 
-## Creating a New Project
-In this example, we will be using poetry as our virtual environment manager.
+### Virtual Environments
+It is highly recommended that you use virtual environments to ensure that your CrewAI project is isolated from other projects and dependencies. Virtual environments provide a clean, separate workspace for each project, preventing conflicts between different versions of packages and libraries. This isolation is crucial for maintaining consistency and reproducibility in your development process. You have multiple options for setting up virtual environments depending on your operating system and Python version:
 
+1. Use venv (Python's built-in virtual environment tool):
+   venv is included with Python 3.3 and later, making it a convenient choice for many developers. It's lightweight and easy to use, perfect for simple project setups.
+
+   To set up virtual environments with venv, refer to the official [Python documentation](https://docs.python.org/3/tutorial/venv.html).
+
+2. Use Conda (A Python virtual environment manager):
+   Conda is an open-source package manager and environment management system for Python. It's widely used by data scientists, developers, and researchers to manage dependencies and environments in a reproducible way.
+
+   To set up virtual environments with Conda, refer to the official [Conda documentation](https://docs.conda.io/projects/conda/en/stable/user-guide/getting-started.html).
+
+3. Use Poetry (A Python package manager and dependency management tool):
+   Poetry is an open-source Python package manager that simplifies the installation of packages and their dependencies. Poetry offers a convenient way to manage virtual environments and dependencies.
+   Poetry is CrewAI's preferred tool for package / dependency management in CrewAI.
+
+### Code IDEs
+
+Most users of CrewAI use a Code Editor / Integrated Development Environment (IDE) for building their Crews. You can use any code IDE of your choice. See below for some popular options for Code Editors / Integrated Development Environments (IDE):
+
+- [Visual Studio Code](https://code.visualstudio.com/) - Most popular
+- [PyCharm](https://www.jetbrains.com/pycharm/)
+- [Cursor AI](https://cursor.com)
+
+Pick one that suits your style and needs.
+
+## Creating a New Project
+In this example, we will be using Venv as our virtual environment manager.
+
+To set up a virtual environment, run the following CLI command:
 To create a new CrewAI project, run the following CLI command:
 
 ```shell

docs/how-to/LLM-Connections.md

@@ -143,12 +143,13 @@ os.environ["OPENAI_MODEL_NAME"]='mistral-small'
 from langchain_community.chat_models.solar import SolarChat
 ```
 ```sh
-os.environ[SOLAR_API_BASE]="https://api.upstage.ai/v1/solar"
-os.environ[SOLAR_API_KEY]="your-solar-api-key"
+os.environ["SOLAR_API_BASE"]='https://api.upstage.ai/v1/solar'
+os.environ["SOLAR_API_KEY"]='your-solar-api-key'
+```
 
 # Free developer API key available here: https://console.upstage.ai/services/solar
 # Langchain Example: https://github.com/langchain-ai/langchain/pull/18556
-```
+
 
 ### Cohere
 ```python

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "crewai"
-version = "0.55.2"
+version = "0.54.0"
 description = "Cutting-edge framework for orchestrating role-playing, autonomous AI agents. By fostering collaborative intelligence, CrewAI empowers agents to work together seamlessly, tackling complex tasks."
 authors = ["Joao Moura <joao@crewai.com>"]
 readme = "README.md"
@@ -20,8 +20,8 @@ opentelemetry-api = "^1.22.0"
 opentelemetry-sdk = "^1.22.0"
 opentelemetry-exporter-otlp-proto-http = "^1.22.0"
 instructor = "1.3.3"
-regex = "^2024.7.24"
-crewai-tools = { version = "^0.12.0", optional = true }
+regex = "^2023.12.25"
+crewai-tools = { version = "^0.8.3", optional = true }
 click = "^8.1.7"
 python-dotenv = "^1.0.0"
 appdirs = "^1.4.4"
@@ -47,7 +47,7 @@ mkdocs-material = { extras = ["imaging"], version = "^9.5.7" }
 mkdocs-material-extensions = "^1.3.1"
 pillow = "^10.2.0"
 cairosvg = "^2.7.1"
-crewai-tools = "^0.12.0"
+crewai-tools = "^0.8.3"
 
 [tool.poetry.group.test.dependencies]
 pytest = "^8.0.0"

src/crewai/__init__.py

@@ -2,7 +2,6 @@ from crewai.agent import Agent
 from crewai.crew import Crew
 from crewai.pipeline import Pipeline
 from crewai.process import Process
-from crewai.routers import Router
 from crewai.task import Task
 
-__all__ = ["Agent", "Crew", "Process", "Task", "Pipeline", "Router"]
+__all__ = ["Agent", "Crew", "Process", "Task", "Pipeline"]

src/crewai/cli/authentication/constants.py

@@ -1,4 +1,4 @@
 ALGORITHMS = ["RS256"]
-AUTH0_DOMAIN = "crewai.us.auth0.com"
-AUTH0_CLIENT_ID = "DEVC5Fw6NlRoSzmDCcOhVq85EfLBjKa8"
-AUTH0_AUDIENCE = "https://crewai.us.auth0.com/api/v2/"
+AUTH0_DOMAIN = "dev-jzsr0j8zs0atl5ha.us.auth0.com"
+AUTH0_CLIENT_ID = "CZtyRHuVW80HbLSjk4ggXNzjg4KAt7Oe"
+AUTH0_AUDIENCE = "https://dev-jzsr0j8zs0atl5ha.us.auth0.com/api/v2/"

src/crewai/cli/cli.py

@@ -203,11 +203,10 @@ def deploy():
 
 
 @deploy.command(name="create")
-@click.option("-y", "--yes", is_flag=True, help="Skip the confirmation prompt")
-def deploy_create(yes: bool):
+def deploy_create():
     """Create a Crew deployment."""
     deploy_cmd = DeployCommand()
-    deploy_cmd.create_crew(yes)
+    deploy_cmd.create_crew()
 
 
 @deploy.command(name="list")

src/crewai/cli/deploy/api.py

@@ -18,7 +18,7 @@ class CrewAPI:
             "User-Agent": f"CrewAI-CLI/{get_crewai_version()}",
         }
         self.base_url = getenv(
-            "CREWAI_BASE_URL", "https://crewai.com/crewai_plus/api/v1/crews"
+            "CREWAI_BASE_URL", "https://dev.crewai.com/crewai_plus/api/v1/crews"
         )
 
     def _make_request(self, method: str, endpoint: str, **kwargs) -> requests.Response:

src/crewai/cli/deploy/main.py

@@ -28,7 +28,9 @@ class DeployCommand:
             self._telemetry.set_tracer()
             access_token = get_auth_token()
         except Exception:
-            self._deploy_signup_error_span = self._telemetry.deploy_signup_error_span()
+            self._deploy_signup_error_span = self._telemetry.deploy_signup_error_span(
+                self
+            )
             console.print(
                 "Please sign up/login to CrewAI+ before using the CLI.",
                 style="bold red",
@@ -38,10 +40,7 @@ class DeployCommand:
 
         self.project_name = get_project_name()
         if self.project_name is None:
-            console.print(
-                "No project name found. Please ensure your project has a valid pyproject.toml file.",
-                style="bold red",
-            )
+            console.print("No project name found. Please ensure your project has a valid pyproject.toml file.", style="bold red")
             raise SystemExit
 
         self.client = CrewAPI(api_key=access_token)
@@ -101,7 +100,7 @@ class DeployCommand:
         Args:
             uuid (Optional[str]): The UUID of the crew to deploy.
         """
-        self._start_deployment_span = self._telemetry.start_deployment_span(uuid)
+        self._start_deployment_span = self._telemetry.start_deployment_span(self, uuid)
         console.print("Starting deployment...", style="bold blue")
         if uuid:
             response = self.client.deploy_by_uuid(uuid)
@@ -117,12 +116,12 @@ class DeployCommand:
         else:
             self._handle_error(json_response)
 
-    def create_crew(self, confirm: bool) -> None:
+    def create_crew(self) -> None:
         """
         Create a new crew deployment.
         """
-        self._create_crew_deployment_span = (
-            self._telemetry.create_crew_deployment_span()
+        self._create_crew_deployment_span = self._telemetry.create_crew_deployment_span(
+            self
         )
         console.print("Creating deployment...", style="bold blue")
         env_vars = fetch_and_json_env_file()
@@ -130,13 +129,10 @@ class DeployCommand:
 
         if remote_repo_url is None:
             console.print("No remote repository URL found.", style="bold red")
-            console.print(
-                "Please ensure your project has a valid remote repository.",
-                style="yellow",
-            )
+            console.print("Please ensure your project has a valid remote repository.", style="yellow")
             return
 
-        self._confirm_input(env_vars, remote_repo_url, confirm)
+        self._confirm_input(env_vars, remote_repo_url)
         payload = self._create_payload(env_vars, remote_repo_url)
 
         response = self.client.create_crew(payload)
@@ -145,22 +141,18 @@ class DeployCommand:
         else:
             self._handle_error(response.json())
 
-    def _confirm_input(
-        self, env_vars: Dict[str, str], remote_repo_url: str, confirm: bool
-    ) -> None:
+    def _confirm_input(self, env_vars: Dict[str, str], remote_repo_url: str) -> None:
         """
         Confirm input parameters with the user.
 
         Args:
             env_vars (Dict[str, str]): Environment variables.
             remote_repo_url (str): Remote repository URL.
-            confirm (bool): Whether to confirm input.
         """
-        if not confirm:
-            input(f"Press Enter to continue with the following Env vars: {env_vars}")
-            input(
-                f"Press Enter to continue with the following remote repository: {remote_repo_url}\n"
-            )
+        input(f"Press Enter to continue with the following Env vars: {env_vars}")
+        input(
+            f"Press Enter to continue with the following remote repository: {remote_repo_url}\n"
+        )
 
     def _create_payload(
         self,
@@ -274,7 +266,9 @@ class DeployCommand:
             uuid (Optional[str]): The UUID of the crew to get logs for.
             log_type (str): The type of logs to retrieve (default: "deployment").
         """
-        self._get_crew_logs_span = self._telemetry.get_crew_logs_span(uuid, log_type)
+        self._get_crew_logs_span = self._telemetry.get_crew_logs_span(
+            self, uuid, log_type
+        )
         console.print(f"Fetching {log_type} logs...", style="bold blue")
 
         if uuid:
@@ -297,7 +291,7 @@ class DeployCommand:
         Args:
             uuid (Optional[str]): The UUID of the crew to remove.
         """
-        self._remove_crew_span = self._telemetry.remove_crew_span(uuid)
+        self._remove_crew_span = self._telemetry.remove_crew_span(self, uuid)
         console.print("Removing deployment...", style="bold blue")
 
         if uuid:

src/crewai/cli/templates/crew/pyproject.toml

@@ -6,7 +6,7 @@ authors = ["Your Name <you@example.com>"]
 
 [tool.poetry.dependencies]
 python = ">=3.10,<=3.13"
-crewai = { extras = ["tools"], version = ">=0.55.2,<1.0.0" }
+crewai = { extras = ["tools"], version = ">=0.54.0,<1.0.0" }
 
 
 [tool.poetry.scripts]

src/crewai/cli/templates/pipeline/pyproject.toml

@@ -6,7 +6,7 @@ authors = ["Your Name <you@example.com>"]
 
 [tool.poetry.dependencies]
 python = ">=3.10,<=3.13"
-crewai = { extras = ["tools"], version = ">=0.55.2,<1.0.0" }
+crewai = { extras = ["tools"], version = ">=0.54.0,<1.0.0" }
 asyncio = "*"
 
 [tool.poetry.scripts]

src/crewai/cli/templates/pipeline_router/pyproject.toml

@@ -6,7 +6,7 @@ authors = ["Your Name <you@example.com>"]
 
 [tool.poetry.dependencies]
 python = ">=3.10,<=3.13"
-crewai = { extras = ["tools"], version = ">=0.55.2,<1.0.0" }
+crewai = { extras = ["tools"], version = ">=0.54.0,<1.0.0" }
 
 
 [tool.poetry.scripts]