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

# Gerenciamento de Dependências

> Saiba como instalar e gerenciar pacotes e dependências para seu Replit App em diferentes linguagens.

O Replit oferece várias maneiras de instalar e gerenciar pacotes para seu Replit App. Você pode instalar pacotes usando o [Shell](/pt/references/workspace-tools/shell), pedir ao [Agent](/pt/references/agent/overview/) para fazer isso por você, ou deixar o Replit detectar e instalar automaticamente as dependências ausentes quando você executar seu Replit App.

## Instalar pacotes usando o Shell

Abra a ferramenta **Shell** no Editor de Projeto e execute o comando apropriado para o gerenciador de pacotes da sua linguagem:

<CodeGroup>
  ```bash Node.js (npm) theme={null}
  npm install <package-name>
  ```

  ```bash Node.js (pnpm) theme={null}
  pnpm add <package-name>
  ```

  ```bash Python (poetry) theme={null}
  poetry add <package-name>
  ```

  ```bash Python (pip) theme={null}
  pip install <package-name>
  ```

  ```bash Ruby theme={null}
  bundle add <gem-name>
  ```
</CodeGroup>

Você também pode usar o [Universal Package Manager (UPM)](https://github.com/replit/upm/) do Replit para instalar pacotes em linguagens compatíveis:

```bash theme={null}
upm add <package-name>
```

Para instalar uma versão específica:

```bash theme={null}
upm add 'flask==2.3.3'
```

Para todas as linguagens e gerenciadores de pacotes compatíveis, consulte [UPM: Supported Languages](https://github.com/replit/upm/#supported-languages).

## Instalar pacotes usando o Agent

Você pode pedir ao [Agent](/pt/references/agent/overview/) para instalar pacotes para você diretamente no chat. Por exemplo:

* "Instale o pacote axios"
* "Adicione Flask e SQLAlchemy ao meu projeto"
* "Configure o TailwindCSS"

O Agent instala o pacote usando o gerenciador de pacotes apropriado para o seu projeto e atualiza os arquivos de configuração relevantes.

## Detecção automática de importações

O Replit analisa automaticamente seu código em busca de dependências ausentes cada vez que você seleciona **Run**. Se o seu código importar um pacote que ainda não está instalado, o Replit o detecta e instala a versão mais recente automaticamente.

Por exemplo, se você adicionar `import flask` ao `main.py`, na próxima vez que selecionar **Run**, o **Console** exibirá uma mensagem indicando que o **Flask** está sendo instalado.

<Note>
  Você pode configurar a detecção automática de importações no arquivo [.replit](/pt/references/project-setup/configuration#replit-file) usando a configuração `packager.features.guessImports`.
</Note>

### Substituir a detecção automática

Se o pacote errado foi detectado, ou você precisa de uma versão específica, execute o comando de instalação correto no Shell. Por exemplo:

```bash theme={null}
upm add 'flask==2.3.3'
```

Você também pode excluir pacotes ou caminhos específicos da detecção automática no seu arquivo [.replit](/pt/references/project-setup/configuration#replit-file):

## Gerenciadores de pacotes Python

Quando você cria um Replit App Python, seu gerenciador de pacotes é **poetry** por padrão. Isso significa que `pip install` não gerencia suas dependências. Em vez disso, use `poetry add <package>` ou `upm add <package>` no Shell.

### Mudar de poetry para pip

Se preferir usar `pip`, siga estas etapas:

<Steps>
  <Step>
    Abra o Shell e execute:

    Remova o arquivo de lock para que a infraestrutura de pacotes mude para pip:

    ```bash theme={null}
    rm poetry.lock
    ```
  </Step>

  <Step title="Mova suas dependências">
    Transfira suas dependências da seção `[tool.poetry.dependencies]` em `pyproject.toml` para `requirements.txt`. Por exemplo, `flask = "^3.0.2"` torna-se `flask>=3.0.2,<4`.
  </Step>

  <Step title="Limpe o pyproject.toml">
    Exclua as seções `[tool.poetry...]` do `pyproject.toml`.
  </Step>
</Steps>

Após essas alterações, a infraestrutura de pacotes usa `pip` para todas as operações futuras, e a detecção automática de importações continua funcionando conforme esperado.

## Dependências de sistema com Nix

O Replit suporta todas as linguagens de programação por meio da integração com [Nix](https://nixos.org/). Se você precisar de dependências de nível de sistema além dos pacotes de linguagem padrão, pode adicioná-las ao seu arquivo [replit.nix](/pt/references/project-setup/configuration#replit-nix-file).

### Pacotes Nix

Adicione dependências de nível de sistema editando `replit.nix` diretamente. Você pode pesquisar pacotes disponíveis em [search.nixos.org](https://search.nixos.org/packages).

### Módulos

Os módulos combinam suporte para linguagens de programação, formatadores e gerenciadores de pacotes. Eles fornecem a base para o seu Replit App. Se você criar um Replit App a partir de um template ou repositório GitHub, o Replit instala automaticamente os módulos necessários.

Você pode personalizar módulos e outras configurações do Nix usando o arquivo [.replit](/pt/references/project-setup/configuration#replit-file).

## Configuração do gerenciador de pacotes

Você pode ajustar o comportamento do gerenciamento de pacotes no seu arquivo [.replit](/pt/references/project-setup/configuration#replit-file):

| Configuração                          | Descrição                                                        | Padrão                    |
| ------------------------------------- | ---------------------------------------------------------------- | ------------------------- |
| `packager.language`                   | Linguagem usada para operações de pacotes                        | Detectado automaticamente |
| `packager.features.guessImports`      | Detectar e instalar automaticamente pacotes ausentes ao executar | `true`                    |
| `packager.features.packageSearch`     | Ativar suporte à pesquisa de pacotes                             | `true`                    |
| `packager.features.enabledForHosting` | Exigir instalação de pacotes ao hospedar                         | `false`                   |
| `packager.afterInstall`               | Comando a executar após a instalação de um pacote                | —                         |
| `packager.ignoredPaths`               | Caminhos a ignorar durante a detecção de importações             | `[]`                      |
| `packager.ignoredPackages`            | Pacotes a excluir da detecção automática                         | `[]`                      |