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:

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