---
title: Engine local
slug: aura/engine-local
docTags: 
createdAt: 2025-07-07T20:39:55.890Z
---

## Rodando a Engine localmente pela CLI

### Obtendo o projeto

```bash
git clone http://gitlab.centralit.io/aura/blocks.git
```

Dentro dos repositórios do **blocks**  temos uma pasta chamada **cli**. Acesse a mesma
e compile o executável aura, caso ainda não tenha feito.

```bash
# dentro da raiz do projeto
cd cli
cargo install --path .
```

Aviso:

A partir desse momento o utilitário aura fica disponível para ser utilizado a partir de qualquer pasta



### Configurando as variáveis de ambiente para a cli

É necessário exportar 3 váriaveis de ambiente para o funcionamento do comando `aura`.
As variáveis devem apontar para o local onde os respectivos recursos estão sendo executados.

```bash
export ENGINE_HOST=http://localhost:6060/engine
export LOWTALK_HOST=http://localhost:8989/lowtalk
export LOWWIDGET_HOST=http://localhost:4156/lowwidget
```

Aviso:

Por padrão os servidores acima já estão configurados para as portas e pontos de montagem
definidos no exemplo



### Inicializar servidores

Aviso:

Esse tutorial assume que o suporte as linguagens de programação utilizadas pelo servidor já estão funcionando.
Garanta que os comandos `cargo`, `go` e `npm` estão funcionando.



Aviso:

Garanta que o banco de dados está em execução e devidamente configurado nos arquivos main.sh dos respectivos projetos GO



```bash
# dentro da raiz do projeto
cd engine
sh scripts/main.sh

# dentro da raiz do projeto, em um novo terminal
cd lowtalk
sh scripts/main.sh

# dentro da raiz do projeto, em um novo terminal
cd lowwidget
sh scripts/main.sh

# dentro da raiz do projeto, em um novo terminal
cd wanderson
cargo run -- server -d ./workspace_examples

# dentro da raiz do projeto, em um novo terminal
cd lunaris
cargo run -- server -w ./workspace_examples
```

## Resumo do comando aura

Após a instalação podemos ver os comandos disponíveis dentro da **aura**.

### Ajuda

```bash
# Ajuda do comando aura
aura --help
```

### Workspace

```bash
# Ajuda do subcomando workspace
aura workspace --help

# Retorna a lista de workspaces
aura workspace list

# Remove o workspace passado como parametro (coluna name da lista)
aura workspace remove wpname

# Cria um novo workspace a partir do lábel passado como parâmetro
aura workspace new "Label do Workspace"
```

### Plugin

```bash
# Lista os plugins registrados em um workspace
aura list wpname

# Inspeciona as configurações de um plugin registrado
aura inspect wpname plname

# Remove um plugin registrado
aura remove wpname plname

# Registra um plugin
# Workflow: as propriedades podem ser passadas conforme a solicitação do plugin
aura register wpname "label do plugin" "url_do_manifesto" "propriedade0=valor0&propriedaden=valorn"

# Configura talker padrão e a ordem dos eventos
aura conf wpname -d nometalkerpadrao -o primeiroplugin -o segundoplugin
```

### Fila

```bash
# Lista as filas
aura attendant list

# Remove uma fila
aura attendant remove flname

# Cria uma nova fila
aura attendant new "Label da Fila" -a "email_do_agente1" -a "email_do_agenten" -m "mensagem de captura" -j "mensagem de entrada na fila"

# Abre o atendimento humano para o agente passado no parâmetro
aura attendant open "email_do_agente"
```

### Widget

```bash
# Lista os widgets
aura widget list

# Remove um widget
aura widget remove widget_name

# Cria uma novo widget
# Existem parâmetros adicionais que podem ser obtidos com --help
aura widget new "Label do Widget" 

# Abre o widget passado como parâmetro
aura widget open "nome_do_widget"
```