Instalação

Assista: Construindo Agents e Flows CrewAI com Coding Agent Skills

Instale nossas coding agent skills (Claude Code, Codex, …) para colocar seus agentes de código para funcionar rapidamente com o CrewAI.

Você pode instalar com npx skills add crewaiinc/skills

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

Note

Requisitos de Versão do Python

CrewAI requer Python >=3.10 e <3.14. Veja como verificar sua versão:

python3 --version

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 com sh:
  Terminal window
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```
  Se seu sistema não possuir curl, você pode usar wget:
  Terminal window
```
wget -qO- https://astral.sh/uv/install.sh | sh
```
- No Windows:
  
  Use irm para baixar o script e iex para executá-lo:
  Terminal window
```
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```
  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:
  Terminal window
```
uv tool install crewai
```
  Warning
  Se aparecer um aviso relacionado ao PATH, execute este comando para atualizar seu shell:
  Terminal window
  uv tool update-shell
  Warning
  
  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:
  Terminal window
```
uv tool list
```
- Você deverá ver algo assim:
  Terminal window
```
crewai v0.102.0
- crewai
```
- Caso precise atualizar o crewai, execute:
  Terminal window
```
uv tool install crewai --upgrade
```
Instalação realizada com sucesso! Você está pronto para criar seu primeiro crew! 🎉

Criando um Projeto CrewAI

crewai create crew agora cria um projeto de crew JSON-first. Os agentes ficam em agents/*.jsonc, as tarefas e configurações da crew ficam em crew.jsonc, e crewai run carrega essa definição JSON diretamente.

Gerar Scaffolding do Projeto

Execute o comando CLI do crewai:
Terminal window
```
crewai create crew <your_project_name>
```

Isso criará um novo projeto com a seguinte estrutura:

my_project/
├── .gitignore
├── .env
├── agents/
│   └── researcher.jsonc
├── crew.jsonc
├── knowledge/
├── pyproject.toml
├── README.md
├── skills/
└── tools/

Se você precisar do scaffold antigo em Python/YAML com crew.py, config/agents.yaml e config/tasks.yaml, execute:
Terminal window
```
crewai create crew <your_project_name> --classic
```

Personalize Seu Projeto

Seu projeto conterá estes arquivos essenciais:

Arquivo	Finalidade
`crew.jsonc`	Configure a crew, a ordem das tarefas, o processo e os inputs padrão
`agents/*.jsonc`	Defina o papel, objetivo, backstory, LLM, ferramentas e comportamento de cada agente
`.env`	Armazene chaves de API e variáveis de ambiente
`tools/`	Arquivos Python opcionais para ferramentas `custom:<name>`
`knowledge/`	Arquivos opcionais de conhecimento para agentes
`skills/`	Arquivos opcionais de skills aplicadas à crew

Comece editando crew.jsonc e os arquivos em agents/ para definir o comportamento da crew.
Use valores {placeholder} nos textos de agentes e tarefas e defina padrões em crew.jsonc dentro de inputs. Ao executar crewai run, a CLI pergunta por valores que estiverem faltando.
Mantenha informações sensíveis como chaves de API no arquivo .env.

Execute seu Crew
- Antes de rodar seu crew, execute:
  Terminal window
```
crewai install
```
- Se precisar instalar pacotes adicionais, utilize:
  Terminal window
```
uv add <package-name>
```
- Para rodar seu crew, execute o seguinte comando na raiz do seu projeto:
  Terminal window
```
crewai run
```

Opções de Instalação Enterprise

Próximos Passos

Início rápido: Flow + agente

Siga o guia rápido para gerar um Flow, executar um crew com um agente e produzir um relatório.

Junte-se à Comunidade

Conecte-se com outros desenvolvedores, obtenha ajuda e compartilhe suas experiências com o CrewAI.