GUIA PARA COMEÇAR · WINDOWS
Do primeiro login
à primeira sessão.
Instale o Ginga, conecte o Oh My Pi e deixe seus modelos disponíveis em um só lugar. Siga os passos na ordem; não precisa saber programar.
O OMP é o agente que conversa com os modelos. O Ginga é a interface visual para organizar projetos e sessões. Em uma instalação local, as credenciais ficam no OMP deste computador; o modelo pode responder por um serviço na nuvem ou por um motor local, como Ollama.
PRIMEIRO, O ESPAÇO DE TRABALHO
Instale o Ginga
- Baixe o instalador para Windows · 64 bits pelo botão abaixo.
- Abra o arquivo baixado e siga as instruções do instalador.
- Inicie o Ginga pelo menu Iniciar.
O Ginga é gratuito. O uso dos modelos pode ter custo cobrado diretamente pelo provedor da sua conta.
O AGENTE QUE EXECUTA AS TAREFAS
Instale o Oh My Pi
Para o modo local, instale o OMP no mesmo computador do Ginga. Se o aplicativo desktop mostrar Instalar OMP, use esse botão para baixar e validar o OMP oficial.
Uma página web não consegue instalar programas no seu computador. Use o instalador do Ginga para Windows; ou, se preferir instalar o OMP manualmente, abra o PowerShell e execute o comando oficial abaixo.
irm https://omp.sh/install.ps1 | iexQuando terminar, feche e abra uma nova janela do PowerShell e confira:
omp --versionSe o Windows disser que não reconhece `omp`, abra uma nova janela do terminal. Se continuar, reinicie o computador e tente outra vez.
SUAS CONTAS E SEUS MODELOS
Autentique cada provedor no OMP
As contas são configuradas no próprio OMP. Cada provedor é independente: entrar na Anthropic, por exemplo, não autentica sua conta OpenAI ou Google. Você só precisa cadastrar os provedores que pretende usar.
- Abra o PowerShell no Windows.
- Digite
omp logine pressione Enter para abrir o cadastro de provedor. Dentro de uma sessão interativa do OMP, você também pode usar/login. - Escolha um provedor, como Anthropic, OpenAI Codex, Google Gemini ou OpenRouter.
- Siga as instruções do provedor: alguns abrem uma página para entrar na conta; outros pedem uma chave de API.
- Repita o processo para cada provedor que quer habilitar. Um login não libera os outros.
omp modelsDigite a chave somente no fluxo de autenticação do OMP quando ele pedir. Não coloque chaves em mensagens, capturas de tela, arquivos do projeto ou na landing page. No modo local, o OMP guarda a autenticação no perfil local dele. Nunca envie sua chave ao reportar um problema.
AGORA, NO GINGA
Conecte um projeto e escolha um modelo
- Abra o Ginga. O indicador à esquerda deve mostrar que o OMP foi encontrado e está pronto.
- Na Biblioteca, adicione a pasta do projeto que quer trabalhar ou selecione uma pasta existente.
- Abra uma sessão existente ou crie uma nova dentro do projeto.
- Clique em Conectar sessão. O Ginga carrega o histórico daquela conversa.
- No seletor Modelo no topo, escolha um modelo autenticado. Comece com uma instrução curta e confira a resposta e os arquivos alterados.
Volte ao PowerShell e execute omp login para conferir a autenticação. Depois, use o botão de atualizar modelos no Ginga ou reconecte. O seletor só mostra modelos disponíveis para essa instalação do OMP.
CONTINUE DE ONDE PAROU
Traga uma sessão que começou no terminal
As conversas são salvas pelo OMP, não apenas pela janela do Ginga. Você pode começar no terminal e abrir a mesma sessão no Ginga depois.
- Abra o PowerShell na pasta do seu projeto e inicie uma sessão do OMP.
- Depois, abra o Ginga e adicione essa pasta à Biblioteca, se ela ainda não estiver lá.
- Use Sincronizar todas as sessões do OMP na Biblioteca.
- Abra a sessão importada dentro do projeto correspondente. O histórico fica disponível para continuar a conversa.
Escolher outro modelo muda quem responde aos próximos pedidos. O OMP mantém a conversa salva na mesma sessão, para que o próximo modelo receba o histórico disponível daquela conversa. A troca não garante que provedores diferentes interpretem o contexto da mesma forma; confira a resposta antes de confiar em mudanças importantes.
EXPERIMENTAL · SESSÕES DE TERMINAL
Abra uma sessão no celular
O OMP pode compartilhar uma sessão interativa do terminal com o navegador do telefone. O computador continua hospedando o agente e os arquivos; o celular abre o cliente de colaboração do OMP.
- No terminal do OMP, habilite o compartilhamento de leitura para a sessão usando
/collab view. Se preferir, no Ginga web abra Configurações → Acesso pelo celular e escolha Leitura ou Controle para novas sessões interativas. A opção vem desligada e altera uma preferência global do OMP; ela não gera nem publica links sozinha. - No Ginga web conectado ao mesmo OMP local, abra Celular, selecione a sessão e escolha QR somente leitura.
- Escaneie o QR com a câmera do telefone. A página segura do OMP abre a sessão; deixe o OMP e o computador conectados à internet.
- Use Permitir controle apenas se o host oferecer esse acesso e você quiser enviar instruções ou interromper o agente pelo telefone.
Trate QR e link como senha temporária: leitura expõe a sessão; controle também permite enviar instruções. Não os publique nem inclua em capturas, logs ou reports. O recurso móvel ainda está em teste e não faz parte do instalador Windows publicado atualmente.
O diálogo atual lista sessões interativas do terminal que o OMP compartilhou. Sessões RPC criadas dentro do Ginga ainda não aparecem, e não é possível iniciar um novo agente pelo telefone. A inscrição configurada no Ginga só vale para futuras sessões interativas; sessões RPC continuam fora deste fluxo. Para uma lista automática persistente de sessões Collab existe o projeto comunitário OMP Session Gateway; ele exige Bun e Tailscale configurados separadamente, e não está integrado nem homologado pelo Ginga.
OPCIONAL · ROTEAMENTO AUTOMÁTICO
Configure o Jev para escolher o modelo
Você pode continuar escolhendo o modelo manualmente. Para deixar o Ginga classificar a tarefa e selecionar um dos modelos que já autenticou no OMP, abra Auto no topo e configure o roteamento.
- Para classificar com o Jev via OpenRouter, cadastre a chave no formulário de Auto do Ginga e salve. A chave é protegida neste computador; não precisa criar uma variável no terminal.
- Escolha se o Auto pode usar modelos de vários provedores ou apenas de um provedor.
- Escolha modelos autorizados para tarefas leves, normais e complexas. Para fallback, selecione um modelo autenticado no OMP.
- Ative Auto e confira no histórico as decisões, o modelo selecionado e o uso que cada serviço informar.
O login de cada provedor fica no OMP e habilita seus modelos. A chave OpenRouter do Jev, cadastrada no modal Auto, serve somente ao classificador. Para usar um modelo OpenRouter como resposta, autentique também o provider OpenRouter no OMP. Auto é opcional: sem ativá-lo, você escolhe o modelo manualmente.
RESOLUÇÃO RÁPIDA
Se algo não aparecer
O Ginga diz que não encontrou o OMP
Confirme a instalação com omp --version no PowerShell. Abra o Ginga de novo. No app desktop, você também pode usar Instalar OMP ou indicar o executável em Configurações → Conexão avançada.
O provedor não aparece no menu de modelos
Execute omp login no PowerShell ou use /login dentro de uma sessão do OMP. Confirme que o login terminou sem erro e atualize a lista de modelos no Ginga. Alguns provedores exigem uma chave criada na própria conta deles.
Minha sessão do terminal não aparece
Confirme que a pasta correta está na Biblioteca e clique em Sincronizar todas as sessões do OMP. Se o OMP salva sessões em uma pasta personalizada, adicione essa origem em Gerenciar pastas de sessões OMP e sincronize novamente.
Quero usar o Ginga em uma VPS
O site público não consegue acessar o OMP instalado no seu computador. Para uso remoto, configure uma conexão segura com a máquina que executa o OMP; não exponha o companion nem uma porta local à internet. Este guia cobre o modo local do Windows.
Posso usar o Ginga só pelo site?
Não para acessar um OMP instalado no seu computador. O site apresenta o produto e oferece o download; para uso normal, instale o aplicativo desktop. A versão web de desenvolvimento exige um companion local ativo na mesma máquina.
O Ginga cobra pelas respostas?
O Ginga é gratuito. O provedor escolhido pode cobrar pelo uso conforme sua conta, plano e modelo. Verifique os preços e limites diretamente com o provedor.
PRONTO PARA CONTINUAR