Instalação
Comece a usar o CrewAI - Instale, configure e crie seu primeiro crew de IA
Tutorial em Vídeo
Assista a este tutorial em vídeo para uma demonstração passo a passo do processo de instalação:
Tutorial em Texto
Requisitos de Versão do Python
CrewAI requer Python >=3.10 e <3.14
. Veja como verificar sua versão:
Se você precisar atualizar o Python, acesse python.org/downloads
CrewAI utiliza o uv
como ferramenta de gerenciamento de dependências e pacotes. Ele simplifica a configuração e execução do projeto, oferecendo uma experiência fluida.
Se você ainda não instalou o uv
, siga o passo 1 para instalá-lo rapidamente em seu sistema, caso contrário, avance para o passo 2.
Instale o uv
-
No macOS/Linux:
Use
curl
para baixar o script e executá-lo comsh
:Se seu sistema não possuir
curl
, você pode usarwget
: -
No Windows:
Use
irm
para baixar o script eiex
para executá-lo:Caso enfrente algum problema, consulte o guia de instalação do UV para mais informações.
Instale o CrewAI 🚀
-
Execute o seguinte comando para instalar o CLI do
crewai
:Se aparecer um aviso relacionado ao
PATH
, execute este comando para atualizar seu shell:Se você encontrar o erro de build ao instalar
chroma-hnswlib==0.7.6
(fatal error C1083: Cannot open include file: 'float.h'
) no Windows, instale o (Visual Studio Build Tools)[https://visualstudio.microsoft.com/downloads/] com o Desenvolvimento de Desktop com C++. -
Para verificar se o
crewai
está instalado, execute: -
Você deverá ver algo assim:
-
Caso precise atualizar o
crewai
, execute:
Criando um Projeto CrewAI
Recomendamos utilizar o template de scaffolding YAML
para uma abordagem estruturada na definição dos agentes e tarefas. Veja como começar:
Gerar Scaffolding do Projeto
-
Execute o comando CLI do
crewai
: -
Isso criará um novo projeto com a seguinte estrutura:
Personalize Seu Projeto
-
Seu projeto conterá estes arquivos essenciais:
Arquivo Finalidade agents.yaml
Defina seus agentes de IA e seus papéis tasks.yaml
Configure as tarefas e fluxos de trabalho dos agentes .env
Armazene chaves de API e variáveis de ambiente main.py
Ponto de entrada e fluxo de execução do projeto crew.py
Orquestração e coordenação do crew tools/
Diretório para ferramentas customizadas dos agentes knowledge/
Diretório para base de conhecimento -
Comece editando
agents.yaml
etasks.yaml
para definir o comportamento do seu crew. -
Mantenha informações sensíveis como chaves de API no arquivo
.env
.
Execute seu Crew
- Antes de rodar seu crew, execute:
- Se precisar instalar pacotes adicionais, utilize:
- Para rodar seu crew, execute o seguinte comando na raiz do seu projeto:
Opções de Instalação Enterprise
Para equipes e organizações, o CrewAI oferece opções de implantação corporativa que eliminam a complexidade da configuração:
CrewAI Enterprise (SaaS)
- Zero instalação necessária - basta se cadastrar gratuitamente em app.crewai.com
- Atualizações e manutenção automáticas
- Infraestrutura e escalabilidade gerenciadas
- Construa crews sem código
CrewAI Factory (Auto-Hospedado)
- Implantação containerizada para sua infraestrutura
- Compatível com qualquer hyperscaler, incluindo ambientes on-premises
- Integração com seus sistemas de segurança existentes
Explore as Opções Enterprise
Saiba mais sobre as soluções enterprise do CrewAI e agende uma demonstração