> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crewai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Instalação

> Comece a usar o CrewAI - Instale, configure e crie seu primeiro crew de IA

### 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`

[https://www.loom.com/embed/befb9f68b81f42ad8112bfdd95a780af](https://www.loom.com/embed/befb9f68b81f42ad8112bfdd95a780af)

## Tutorial em Vídeo

Assista a este tutorial em vídeo para uma demonstração passo a passo do processo de instalação:

[CrewAI Installation Guide](https://www.youtube.com/embed/-kSOTtYzgEw)

## Tutorial em Texto

> [!NOTE]
>
> **Requisitos de Versão do Python**
>
> CrewAI requer `Python >=3.10 e <3.14`. Veja como verificar sua versão:
>
> ```bash theme={null}
> python3 --version
> ```
>
> Se você precisar atualizar o Python, acesse [python.org/downloads](https://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`:

  ```shell theme={null}
  curl -LsSf https://astral.sh/uv/install.sh | sh
  ```

  Se seu sistema não possuir `curl`, você pode usar `wget`:

  ```shell theme={null}
  wget -qO- https://astral.sh/uv/install.sh | sh
  ```

* **No Windows:**

  Use `irm` para baixar o script e `iex` para executá-lo:

  ```shell theme={null}
  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  ```

  Caso enfrente algum problema, consulte o [guia de instalação do UV](https://docs.astral.sh/uv/getting-started/installation/) para mais informações.

**2. Instale o CrewAI 🚀**

* Execute o seguinte comando para instalar o CLI do `crewai`:

  ```shell theme={null}
  uv tool install crewai
  ```

  > [!WARNING]
  >
  > Se aparecer um aviso relacionado ao `PATH`, execute este comando para atualizar seu shell:
  >
  > ```shell theme={null}
  > 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/](https://visualstudio.microsoft.com/downloads/)] com o *Desenvolvimento de Desktop com C++*.

* Para verificar se o `crewai` está instalado, execute:
  ```shell theme={null}
  uv tool list
  ```

* Você deverá ver algo assim:
  ```shell theme={null}
  crewai v0.102.0
  - crewai
  ```

* Caso precise atualizar o `crewai`, execute:
  ```shell theme={null}
  uv tool install crewai --upgrade
  ```

> [!TIP]
>
> 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.

**1. Gerar Scaffolding do Projeto**

* Execute o comando CLI do `crewai`:
  ```shell theme={null}
  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:
  ```shell theme={null}
  crewai create crew <your_project_name> --classic
  ```

**2. 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`.

**3. Execute seu Crew**

* Antes de rodar seu crew, execute:
  ```bash theme={null}
  crewai install
  ```
* Se precisar instalar pacotes adicionais, utilize:
  ```shell theme={null}
  uv add <package-name>
  ```
* Para rodar seu crew, execute o seguinte comando na raiz do seu projeto:
  ```bash theme={null}
  crewai run
  ```

## Opções de Instalação Enterprise

> [!NOTE]
>
> Para equipes e organizações, o CrewAI oferece opções de implantação corporativa que eliminam a complexidade da configuração:
>
> ### CrewAI AMP (SaaS)
>
> * Zero instalação necessária - basta se cadastrar gratuitamente em [app.crewai.com](https://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](https://share.hsforms.com/1Ooo2UViKQ22UOzdr7i77iwr87kg)**
> >
> > Saiba mais sobre as soluções enterprise do CrewAI e agende uma demonstração

## Próximos Passos

> **[Início rápido: Flow + agente](https://docs.crewai.com/pt-BR/quickstart.md)**
>
> Siga o guia rápido para gerar um Flow, executar um crew com um agente e produzir um relatório.

> **[Junte-se à Comunidade](https://community.crewai.com)**
>
> Conecte-se com outros desenvolvedores, obtenha ajuda e compartilhe suas
> experiências com o CrewAI.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.