Primeiros passos com Marinara Engine
Marinara Engine é um aplicativo para conversar e fazer roleplay com personagens de IA. Ele roda no seu próprio computador. Este guia mostra a tela inicial e os passos até o seu primeiro chat.
Comece o seu primeiro chat
Antes de começar: você precisa de uma chave de API (um código secreto, parecido com uma senha) de um serviço de IA, ou do Built-in model (modelo embutido) descrito abaixo.
- Instale Marinara Engine e abra o aplicativo no navegador. Escolha a sua plataforma em Instalação do Marinara Engine.
- Adicione uma conta. Uma conta é uma chave de API de um serviço de IA. Veja Conectando a um provedor de IA.
- Escolha os modelos que a conta deve usar. O mesmo guia mostra como.
- Crie ou importe um personagem. Abra o painel Characters (personagens) e clique em New para abrir a janela Create Character, ou clique em Import para trazer um card de um arquivo. Veja Criando e editando personagens.
- Abra a barra lateral de chats com o botão da barra lateral. As abas dela mostram CONVO, RP e GM. Escolha uma e clique no botão +. Ele se chama New Conversation, New Roleplay ou New Game, de acordo com a aba.
- Siga a janela de configuração que se abre e clique em Create Chat (criar chat).
O que você vê: o chat novo se abre, e você pode escrever a sua primeira mensagem.
Se você ainda não tiver nenhuma conta, a janela de adicionar conta abre antes e termina com Start chatting (começar a conversar). Se uma janela Set Up pedir que você escolha uma conta, escolha uma da lista e clique em Create Chat.
Marinara não inclui uma IA online. A maioria das pessoas se conecta a um serviço online. Você também pode baixar o Built-in model, um modelo pequeno que roda no seu computador sem chave de API. Ele serve para tarefas auxiliares leves, não para o seu chat principal. Veja Como configurar o Built-in model.
Na primeira vez que você abre Marinara, começa um tour guiado curto. Veja O tutorial da primeira vez. Travou em algum passo? Pergunte à Professor Mari, a assistente integrada: Professor Mari, a assistente dentro do aplicativo.
A tela inicial em resumo
A tela inicial aparece quando nenhum chat está aberto. Ela lembra um navegador da web: abas e favoritos no topo e widgets abaixo.
- Abas. Home é a página principal. Professor abre a Professor Mari. Alguns agentes instalados acrescentam uma aba própria.
- Barra de busca. No computador, clique na barra abaixo das abas, ou pressione <kbd>Ctrl</kbd>+<kbd>K</kbd> (<kbd>⌘</kbd>+<kbd>K</kbd> no Mac), para encontrar chats, personagens, configurações e mais. Celulares, tablets e janelas estreitas não mostram essa barra.
- Favoritos. Atalhos para Discord, Support, Credits, Documentation, Tutorial, FAQ, Achievements e Widgets. Achievements só aparece quando a configuração Achievements está ativada. Os favoritos só aparecem na aba Home. No celular, no tablet ou em uma janela estreita, toque no botão de favoritos (Open bookmarks: abrir os favoritos) à esquerda das abas para vê-los como uma lista.
No meio ficam o logotipo, Marinara Engine e o número da versão. Abaixo deles, os botões Conversation, Roleplay e Game começam cada um um chat novo nesse modo.
Escolha um modo de chat
Você escolhe um modo ao começar um chat.
- Conversation: um chat simples com a IA, com visual de aplicativo de mensagens. Veja Conversation Mode: primeiros passos.
- Roleplay: uma história com um ou mais personagens. O aplicativo acompanha a cena, como o lugar e a hora. Veja Roleplay Mode: primeiros passos.
- Game: um jogo para um jogador. A IA faz o papel do Game Master, que conta a história. Você tem um grupo de companheiros (a equipe), rolagens de dados, mapas e missões. Veja Game Mode: primeiros passos.
Widgets da tela inicial
Widgets são pequenos cartões que você pode mostrar, esconder e mover.
- Clique em Widgets nos favoritos. A janela Home Widgets (widgets da tela inicial) se abre. Ela lista os widgets em Built-in (integrados), Agents (agentes) e Personal (pessoais).
- Clique no botão de olho ao lado de um widget para mostrá-lo ou escondê-lo. Um widget que você volta a mostrar vai para o primeiro lugar livre da tela inicial.
- Para mover um widget, arraste a alça no canto superior direito dele. No computador, a alça aparece quando você aponta para o widget.
O seu layout fica salvo neste navegador. Os widgets pessoais também têm botões para editá-los ou excluí-los. Na parte de baixo da janela, Browser chrome (moldura do navegador) tem um botão liga/desliga: Show URL bar (mostrar a barra de endereço) mostra ou esconde a barra de busca no computador.
A Professor Mari pode criar um widget pessoal para você, se você pedir. Os agentes instalados também podem acrescentar widgets.
Referência: widgets integrados
| Widget | O que faz | Aparece no início |
| Professor Mari | Ask Professor Mari (falar com a Professor Mari) abre o chat dela. | Sim |
| Recent chats (chats recentes) | Os seus chats mais recentes. Clique em um para reabri-lo. Vazio: Your chats will show here (os seus chats vão aparecer aqui). | Sim |
| Learn the engine (conhecer o Engine) | Links para Documentation, Replay tutorial (repetir o tutorial) e Read FAQ (ler o FAQ). | Sim |
| What's New (novidades) | See what's new (ver as novidades) e Read release notes (ler as notas de versão). | Sim |
| Community (comunidade) | Links para Discord, Support e Credits. | Sim |
| Character Library (biblioteca de personagens) | Uma seleção nova dos seus personagens a cada dia. | Não |
| Discovery desk (mesa de descobertas) | Agentes que você ainda não instalou. Browse agents (navegar pelos agentes) abre o catálogo. | Não |
| Character of the Day (personagem do dia) | Um personagem da sua biblioteca, com Start a chat (começar um chat) e View character (ver o personagem). | Não |
| Clock & calendar (relógio e calendário) | A data e a hora de hoje. | Não |
| Achievements (conquistas) | As suas conquistas mais recentes e as mais perto de sair. Precisa da configuração Achievements ativada. | Não |
Onde buscar ajuda
- Pergunte à Professor Mari na tela inicial.
- Abra o favorito FAQ para respostas rápidas.
- Abra o favorito Documentation para ler os guias dentro do aplicativo.
- Clique em Discord para falar com a comunidade, ou em Support para apoiar o projeto.
Se algo estiver quebrado, veja Solução de problemas do Marinara Engine.
Guias relacionados
- Instalação do Marinara Engine
- Conectando a um provedor de IA
- Criando e editando personagens
- O tutorial da primeira vez
- Professor Mari, a assistente dentro do aplicativo