Comment installer CrewAI : toutes les méthodes (pip, conda, Docker, source)

Introduction

CrewAI est un framework open source qui permet d'orchestrer des agents IA autonomes collaborant sur des tâches complexes. Avant de profiter de ses capacités, il faut d'abord l'installer correctement.

Ce tutoriel couvre :

pip — méthode standard pour la plupart des développeurs
conda/mamba — pour les environnements data science
Docker — isolation parfaite, idéal pour CI/CD
Source — pour contribuer ou tester des features non publiées

Que vous soyez sur Windows, macOS ou Linux, vous trouverez ici la procédure adaptée à votre environnement.

Résumé rapide

Méthode	Commande	Use case idéal
pip	`pip install crewai`	Usage standard
conda/mamba	`conda install -c conda-forge crewai`	Environnements data science
Docker	`docker pull crewai/crewai`	Isolation, CI/CD
Source	`git clone` + `poetry install`	Contribuer, tester les dernières features

Prérequis communs : Python 3.9+, clé API (OpenAI, Cohere, Azure OpenAI…).

Qu'est-ce que CrewAI ?

CrewAI est un framework d'orchestration d'agents IA créé en 2024. Chaque agent a un rôle précis (researcher, writer, analyst…) et accomplit une tâche dans le cadre d'un workflow collaboratif.

Comparer à LangChain ou AutoGen, CrewAI se distingue par :

Syntaxe minimaliste — structure par rôles et par tâches
Task routing automatique — chaque agent sait quelle tâche exécuter ensuite
Tools intégrées — Wikipedia, Selenium, code interpreter, et des dizaines d'autres

Installer CrewAI vous donne accès à un système multi-agents qui collaborent autour d'un objectif commun. Le package officiel est disponible sur PyPI.

Prérequis avant installation

Python 3.9 minimum

python --version
# Doit afficher Python 3.9.x, 3.10.x, 3.11.x ou 3.12.x

Clé API

CrewAI nécessite un provider LLM. Les options supportées :

OpenAI — recommandée pour commencer (GPT-4o, GPT-4 turbo)
Azure OpenAI — via votre tenant Azure
Cohere — command R+, command R
Anthropic — Claude 3.5 Sonnet
Google Vertex AI — Gemini
Groq — instance gratuite, idéal pour prototyper

Stockez votre clé dans une variable d'environnement (jamais en dur dans le code) :

# Linux/macOS
export OPENAI_API_KEY=sk-...

# Windows (PowerShell)
$env:OPENAI_API_KEY="sk-..."

Méthode 1 — Installation pip (recommandée)

C'est la méthode standard pour la majority des scénarios.

Installation simple

pip install crewai

Pour une version pinned et reproductible :

pip install crewai==0.88.0

Vérifiez la version installée :

python -c "import crewai; print(crewai.__version__)"

Erreurs courantes avec pip

Erreur Visual C++ Build Tools (Windows)

error: Microsoft Visual C++ 14.0 or greater is required.

Solution : Téléchargez Visual Studio Build Tools depuis visualstudio.microsoft.com et cochez "Desktop development with C++" lors de l'installation. Redémarrez votre terminal ensuite.

Conflit de dépendances

Si vous avez des conflits avec langchain ou un autre package :

# Créer un environnement propre
python -m venv crewai-env
source crewai-env/bin/activate  # Linux/macOS
crewai-env\Scripts\activate     # Windows

pip install crewai

Méthode 2 — Installation conda / mamba

Pour les développeurs data science qui utilisent déjà conda ou mamba.

Avec conda

conda create -n crewai python=3.11
conda activate crewai
conda install -c conda-forge crewai

Avec mamba (plus rapide)

mamba create -n crewai python=3.11 -c conda-forge
mamba activate crewai
mamba install crewai -c conda-forge

Astuce : Mamba résout les dépendances bien plus rapidement que conda sur les environnements complexes. Si vous utilisez déjà mamba pour vos projets data, privilégiez cette option.

Méthode 3 — Installation Docker

Docker isolate CrewAI dans un container, idéal pour CI/CD ou un setup zero-config.

Image officielle

docker pull crewai/crewai:latest

Lancer un container interactif

docker run -it \
  -e OPENAI_API_KEY=sk-... \
  -v $(pwd):/workspace \
  --name crewai-container \
  crewai/crewai:latest bash

Vos scripts sont montés dans /workspace. CrewAI est déjà installé dans le container.

Docker Compose (recommandé pour le développement)

# docker-compose.yml
version: '3.8'
services:
  crewai:
    image: crewai/crewai:latest
    environment:
      - OPENAI_API_KEY=${OPENAI_API_KEY}
    volumes:
      - ./scripts:/workspace/scripts
    working_dir: /workspace
    stdin_open: true
    tty: true

Lancez avec :

docker-compose up -d
docker-compose exec crewai bash

Méthode 4 — Installation depuis la source (dev)

Pour contribuer à CrewAI ou tester les features non publiées.

git clone https://github.com/crewAIInc/crewAI.git
cd crewAI
poetry install
poetry shell

Poetry installe toutes les dépendances et crée un shell virtuellement isolé avec la version dev de CrewAI.

Vérifiez :

python -c "import crewai; print('Dev OK:', crewai.__version__)"

Cette méthode donne accès aux dernières commits et permet de contribuer via Pull Request sur le repo GitHub.

Vérification de l'installation

Quel que soit la méthode utilisée, vérifiez que CrewAI fonctionne avec ce script minimal :

from crewai import Agent, Task, Crew

# Test basique
print("CrewAI import OK")

# Vérification des tools intégrées
from crewai.tools import Tool
print("Tools import OK")

# Test avec un agent simple (nécessite OPENAI_API_KEY)
agent = Agent(
    role="Test Agent",
    goal="Vérifier que CrewAI fonctionne",
    backstory="Assistant de test"
)
print(f"Agent créé : {agent.role}")
print("Installation fonctionnelle ✓")

Si vous voyez les trois lignes de confirmation, votre installation est opérationnelle.

Premier crew fonctionnel

Créons un crew minimal qui combine deux agents pour une tâche de recherche et synthèse.

import os
from crewai import Agent, Task, Crew, Process

os.environ["OPENAI_API_KEY"] = os.getenv("OPENAI_API_KEY", "")

# Agent 1 — Researcher
researcher = Agent(
    role="Research Analyst",
    goal="Trouver les dernières avancées en IA agentique",
    backstory="Expert en veille technologique, vous surveillez les tendances IA.",
    verbose=True
)

# Agent 2 — Writer
writer = Agent(
    role="Tech Writer",
    goal="Rédiger un résumé clair des découvertes",
    backstory="Rédacteur tech senior, vous rendez complexe simple.",
    verbose=True
)

# Task 1
task1 = Task(
    description="Rechercher 3 articles récents sur les agents IA autonomes et leurs cas d'usage en 2026",
    agent=researcher
)

# Task 2
task2 = Task(
    description="Synthétiser les findings du researcher en 3 bullet points actionnables",
    agent=writer
)

# Orchestration
crew = Crew(
    agents=[researcher, writer],
    tasks=[task1, task2],
    process=Process.hierarchical  # Le writer synthétise les résultats du researcher
)

result = crew.kickoff()
print("Result:", result)

Exécutez :

python crew_basic.py

Output attendu : le researcher trouve 3 articles, le writer les synthétise en 3 points — le tout en environ 30 secondes avec GPT-4o.

Bonnes pratiques

Environnement propre par projet

Créez un virtualenv ou environnement conda dédié par projet pour éviter les conflits de dépendances.

Gestion des clés API

Utilisez .env avec python-dotenv plutôt que des clés en dur
Versionnez .env.example (sans la clé) pour documenter les variables nécessaires
En production, utilisez les secrets de votre plateforme (Vercel, Railway, Render…)

Contrôle des coûts

CrewAI facture par call LLM. Un crew simple coûte quelques centimes par exécution.
Définissez un max_iter sur vos agents pour éviter les boucles infinies.
En développement, utilisez Groq ou Azure OpenAI (moins cher que GPT-4o) pour itérer.

Erreurs fréquentes

Erreur	Cause	Solution
`ModuleNotFoundError: No module named 'crewai'`	Installation ratée ou environnement wrong	Réinstaller dans le bon environnement
`AuthenticationError: Invalid API key`	Clé absente ou mal formatée	Vérifier `OPENAI_API_KEY` dans l'environnement
`RateLimitError`	Trop de requêtes simultanées	Ajouter un délai ou utiliser un modèle plus rapide
`Context window exceeded`	Prompt trop long	Chunk le context ou utiliser un modèle avec plus de contexte

FAQ

Comment vérifier que CrewAI est bien installé ?

python -c "import crewai; print(crewai.__version__)"

Si la version s'affiche sans erreur, l'installation est correcte.

CrewAI est-il gratuit ?

Le framework est open source et gratuit. Seuls les appels aux modèles LLM coûtent de l'argent. Groq propose un tier gratuit généreux pour tester sans facture.

Quelle version de Python est requise ?

Python 3.9 minimum. Python 3.11 est recommandé pour la meilleure compatibilité. Python 3.12 fonctionne également.

Peut-on installer CrewAI sans clé API ?

Non. CrewAI a besoin d'un provider LLM pour fonctionner. Les options gratuites incluent Groq ou Azure OpenAI (credits gratuits pour les nouveaux comptes).

Comment désinstaller CrewAI ?

pip uninstall crewai
# ou avec conda
conda remove crewai

Comment installer CrewAI : toutes les méthodes (pip, conda, Docker, source)

Comment installer CrewAI : toutes les méthodes (pip, conda, Docker, source)

Introduction

Résumé rapide

Qu'est-ce que CrewAI ?

Prérequis avant installation

Python 3.9 minimum

Clé API

Méthode 1 — Installation pip (recommandée)

Installation simple

Erreurs courantes avec pip

Méthode 2 — Installation conda / mamba

Avec conda

Avec mamba (plus rapide)

Méthode 3 — Installation Docker

Image officielle

Lancer un container interactif

Docker Compose (recommandé pour le développement)

Méthode 4 — Installation depuis la source (dev)

Vérification de l'installation

Premier crew fonctionnel

Bonnes pratiques

Environnement propre par projet

Gestion des clés API

Contrôle des coûts

Erreurs fréquentes

FAQ

Articles liés

Restez informé sur les agents IA

Articles liés