​
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 PythonCrewAI 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.
1

Instale o uv

  • No macOS/Linux: Use curl para baixar o script e executá-lo com sh: 
    curl -LsSf https://astral.sh/uv/install.sh | sh
    Se seu sistema não possuir curl, você pode usar wget: 
    wget -qO- https://astral.sh/uv/install.sh | sh
  • No Windows: Use irm para baixar o script e iex para executá-lo: 
    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.
2

Instale o CrewAI 🚀

  • Execute o seguinte comando para instalar o CLI do crewai: 
    uv tool install crewai
    Se aparecer um aviso relacionado ao PATH, execute este comando para atualizar seu shell:
    uv tool update-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: 
    uv tool list
  • Você deverá ver algo assim: 
    crewai v0.102.0
- crewai
  • Caso precise atualizar o crewai, execute: 
    uv tool install crewai --upgrade
Instalação realizada com sucesso! Você está pronto para criar seu primeiro crew! 🎉

​
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:
1

Gerar Scaffolding do Projeto

  • Execute o comando CLI do crewai: 
    crewai create crew <your_project_name>
  • Isso criará um novo projeto com a seguinte estrutura: 
    my_project/
├── .gitignore
├── knowledge/
├── pyproject.toml
├── README.md
├── .env
└── src/
    └── my_project/
        ├── __init__.py
        ├── main.py
        ├── crew.py
        ├── tools/
        │   ├── custom_tool.py
        │   └── __init__.py
        └── config/
            ├── agents.yaml
            └── tasks.yaml
2

Personalize Seu Projeto

  • Seu projeto conterá estes arquivos essenciais:
    ArquivoFinalidade
    agents.yamlDefina seus agentes de IA e seus papéis
    tasks.yamlConfigure as tarefas e fluxos de trabalho dos agentes
    .envArmazene chaves de API e variáveis de ambiente
    main.pyPonto de entrada e fluxo de execução do projeto
    crew.pyOrquestraçã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 e tasks.yaml para definir o comportamento do seu crew.
  • Mantenha informações sensíveis como chaves de API no arquivo .env.
3

Execute seu Crew

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

​
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

​
Próximos Passos

Construa Seu Primeiro Agente

Siga nosso guia de início rápido para criar seu primeiro agente CrewAI e obter experiência prática.

Junte-se à Comunidade

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