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

# Projetos e configuração do ambiente

> Crie um projeto na nuvem ou um projeto local, deixe a IA configurar o ambiente do projeto, veja sessões, commits, arquivos e prévias de sites na página do projeto, e compartilhe, exporte, configure ou exclua projetos.

Um **projeto** é um conjunto de fontes de código mais as configurações do ambiente. Uma fonte pode ser um repositório do GitHub, uma pasta enviada para o servidor na nuvem ou uma pasta no seu computador. As sessões podem ser executadas dentro de um projeto ou fora de qualquer projeto.

## Projetos na nuvem e projetos locais

* **Projeto na nuvem**: o código fica no seu [servidor na nuvem](https://docs.aihubmix.com/pt/cloud/environments/cloud-host.md). Há três fontes: criar do zero, importar do GitHub ou enviar um projeto local. Requer o Plus.
* **Projeto local**: vinculado a uma pasta em um dos seus computadores. As sessões são executadas nesse computador. Consulte [Executar no seu dispositivo](https://docs.aihubmix.com/pt/cloud/environments/your-device.md). Os arquivos não são enviados, e nenhum servidor na nuvem é necessário.

A barra lateral mostra os projetos em duas seções de acordo com esses tipos, e um projeto nunca passa para a outra seção depois de criado. No aplicativo web ou em outro computador, você pode ver os projetos locais e suas sessões e iniciar novas sessões neles, mas não pode ver arquivos e commits que não foram enviados para a nuvem.

![Lista de projetos](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/projects.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=163abfbe35d19fd703de8fb5a1a5b1fd)

A página de projetos lista todos os projetos do espaço de trabalho

## Criar um projeto

Clique em **+** no título de uma seção da barra lateral, em **New project** na página de projetos ou em **New project** no menu de projetos acima da caixa de entrada da nova sessão. Se você criar um projeto na nuvem sem o Plus, a janela de assinatura abre primeiro. Depois de assinar, clique em Continue para voltar à janela de criação. Os repositórios que você já selecionou são mantidos.

### Criar do zero

**1. Digitar um nome**

Até 64 caracteres. Se ficar vazio, será usado `my-app`.

**2. Escolher um modelo inicial**

Por exemplo Blank, Node · TypeScript, Next.js ou Python, conforme mostrado no app.

**3. Criar**

Se necessário, selecione **Create a private GitHub repository** (requer uma conta do GitHub conectada) e clique em **Create project**.

### Importar do GitHub

**1. Escolher repositórios**

Selecione um ou mais repositórios. Se você selecionar mais de um, o primeiro é o repositório principal e os demais são clonados no projeto junto com ele.

**2. Iniciar a criação**

Clique em **Get started**. Quando terminar, você vai para a página de nova sessão com este projeto selecionado.

![Novo projeto: importar do GitHub](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/new-project.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=c08c4b54fadb27957fe5757eb30d873c)

Importando repositórios do GitHub

Se um repositório não aparecer na lista, clique em **Configure access** para ajustar a autorização no GitHub e depois clique em **Refresh** ao voltar. Se você ainda não conectou o GitHub, consulte [Conectores](https://docs.aihubmix.com/pt/cloud/integrations/connectors.md).

### Enviar um projeto local

Arraste uma pasta para a janela ou clique em **Choose folder…**, confirme a quantidade e o tamanho dos arquivos e clique em **Get started**. Os envios têm estes limites: 2 GiB no total, até 50.000 arquivos e 100 MiB por arquivo. O conteúdo listado em `.gitignore`, `node_modules`, `.git`, arquivos do tipo `.env`, além de credenciais, chaves privadas e certificados, é excluído automaticamente.

Se um envio falhar ou for cancelado, a parte já enviada não é mantida, e uma nova tentativa começa do início. Projetos enviados não têm repositório remoto, então as alterações são entregues como um patch.

> [!NOTE]
>
> Navegadores móveis não conseguem selecionar pastas, então não é possível enviar um projeto local a partir de um celular.

### Vincular uma pasta do seu computador

**1. Escolher uma pasta**

Na janela de novo projeto local, clique em **Add** abaixo da pasta de origem. O nome do projeto é preenchido com o nome da pasta, e você pode alterá-lo.

**2. Criar**

Clique em **Create project** para ir à página de nova sessão. O local de execução padrão é este computador.

Não é possível escolher pastas amplas demais, como a sua pasta pessoal, nem pastas que você não tem permissão para ler. Depois de criar o projeto, você pode adicionar outras pastas do mesmo computador nas configurações do projeto.

> [!NOTE]
>
> Apenas o aplicativo para desktop pode criar projetos locais.

## Configurar o ambiente de um projeto na nuvem

O ambiente do projeto inclui o script de configuração, o comando de inicialização e os segredos e variáveis de ambiente que o projeto usa. A configuração é opcional. Você pode iniciar sessões assim que o projeto for criado. Projetos locais usam o ambiente do próprio computador e pulam esta etapa.

**1. Abrir a página de configuração do ambiente**

Em **Project settings › Environment**, clique no botão de edição. A página de configuração do ambiente é uma página separada no projeto e não aparece na lista de sessões.

**2. Aguardar a IA gerar um rascunho**

A IA lê o repositório e gera o script de configuração, o comando de inicialização e os segredos e variáveis necessários. Nenhum script é executado até você concluir a revisão.

**3. Concluir as três etapas de revisão**

Confirme o script de configuração e o comando de inicialização, preencha os segredos e preencha as variáveis de ambiente, nessa ordem. Depois de preencher os campos obrigatórios, clique em **Finish review**. Se você ainda não tiver os valores, clique em **Respond later**. Os valores já digitados são mantidos.

**4. Publicar**

A IA executa o script de configuração no servidor na nuvem. Quando ele passar, clique em **Publish to cloud server** e depois em **Start a task** para ir a uma nova sessão. Se falhar, clique em **Retry** ou **Edit environment**. Uma falha não impede que você inicie sessões.

Você pode continuar adicionando requisitos na caixa de entrada na parte inferior da página, e a IA reconfigura o ambiente de acordo. Depois de alterar um ambiente publicado, publique-o novamente para que as alterações entrem em vigor. Não envie segredos pela caixa de entrada. Digite-os nas etapas de revisão ou nas configurações de segredos.

## Acompanhar o progresso na página do projeto

Abra um projeto para ver:

* **Recent sessions**: sessões em andamento e aguardando sua aprovação ficam destacadas. Clique em **View all** para ver todas as sessões deste projeto.
* **Commits**: commits recentes no branch atual. Abra um para ver os arquivos alterados e as linhas adicionadas e removidas.
* **Files**: se uma pasta contiver um README, ele é exibido diretamente. Arquivos Markdown e similares podem alternar entre prévia e código-fonte, e podem ser copiados ou compartilhados. Arquivos sensíveis como `.env` e chaves privadas não são exibidos.
* **Website previews**: serviços que este projeto está escutando no servidor na nuvem, por exemplo `localhost:3000`. Clique em **Open** para ver a prévia no app. Uma entrada aparece depois que você pede ao agente para iniciar um servidor de desenvolvimento. As prévias ficam indisponíveis quando o servidor na nuvem não está em execução.

## Compartilhar uma prévia ou um arquivo

**1. Abrir o compartilhamento**

Clique em **Share** em uma prévia de site ou em **Share file** na visualização de arquivo.

**2. Definir acesso e validade**

Escolha Only me, Anyone with the link (padrão) ou Public. A validade vai de 1 a 30 dias (7 dias por padrão).

**3. Copiar o link**

Clique em **Create link** e depois em **Copy link**.

> [!WARNING]
>
> O link é exibido apenas uma vez e não pode ser visto novamente depois que você o fecha. Copie-o imediatamente. Antes de escolher Public, confirme que o conteúdo pode ser tornado público.

Em **My shares**, você pode revogar um link (ele para de funcionar imediatamente) ou compartilhar novamente um link expirado. Compartilhamentos que excedem o limite diário de tráfego são pausados e voltam no dia seguinte.

## Alterar as configurações do projeto

Abra **Project settings** no canto superior direito da página do projeto ou **Edit** no menu de projetos. Clique em **Save** para aplicar as alterações.

* **Name and description**: os nomes têm de 1 a 64 caracteres.
* **Repositories**: o repositório principal não pode ser removido. Você pode puxar a versão mais recente do GitHub. Clique em **Add repository** e digite `owner/name` para clonar outro repositório junto com ele.
* **Base branch**: as sessões criam branches de trabalho a partir deste branch, e os pushes e PRs têm este branch como destino.
* **Ship behavior**: criar um PR (padrão), fazer push de um branch ou personalizado. **Commit author** pode ser AIHubMix Agent (padrão) ou sua conta do GitHub. Para commits e PRs, consulte [Revisar e entregar resultados](https://docs.aihubmix.com/pt/cloud/sessions/review-and-deliver.md).

### Gerenciar segredos e variáveis de ambiente

Adicione e edite-os em **Settings › Workspace › Secrets & variables**. Cada projeto tem seu próprio conjunto, além de um conjunto compartilhado por todos os projetos. Quando os nomes coincidem, o valor do projeto tem prioridade.

* Os segredos são armazenados criptografados, e a IA não consegue ver os valores originais. Você também não consegue ver o valor original ao editar; digite um novo valor para substituí-lo.
* Clique em **Bulk add** para colar diretamente o conteúdo de um `.env`, um `KEY=value` por linha. Nomes que contêm KEY, TOKEN, SECRET ou PASSWORD são salvos como segredos.
* A exclusão não tem segunda confirmação. Ambientes em execução precisam ser reiniciados para que as alterações entrem em vigor.
* Ao executar no seu dispositivo, as configurações do dispositivo controlam quais segredos do espaço de trabalho ficam disponíveis para esse computador. Consulte [Executar no seu dispositivo](https://docs.aihubmix.com/pt/cloud/environments/your-device.md).

### Exportar um projeto

Nas configurações do projeto, clique em **Export…** e depois em **Export**. Quando o empacotamento terminar, clique em **Download archive**. O arquivo não inclui `.env`, segredos, dependências nem caches. O servidor na nuvem precisa estar em execução, e apenas o proprietário do projeto pode exportar.

## Excluir um projeto

No menu de projetos ou nas configurações do projeto, clique em **Delete project…** e confirme. As sessões do projeto são arquivadas e podem ser restauradas em **Settings › Workspace › Archived chats**. Se houver alterações sem push, elas são listadas, e você precisa digitar o nome do projeto para excluí-lo.

> [!WARNING]
>
> A exclusão remove o ambiente na nuvem, os arquivos e os caches de dependências do projeto. Isso não pode ser desfeito. As pastas de projetos locais no seu computador não são afetadas.


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