Pular para conteúdo

Instalação

Esta página fornece instruções detalhadas para instalar e configurar o Grompt em diferentes plataformas.

📦 Opções de Instalação

Opção 1: Download Binário (Recomendado)

A forma mais simples de instalar o Grompt é baixando o binário pré-compilado para sua plataforma:

Windows

# PowerShell
Invoke-WebRequest -Uri "https://github.com/rafa-mori/grompt/releases/latest/download/grompt_windows_amd64.exe" -OutFile "grompt.exe"
.\grompt.exe --help

Linux

# Download e instalação
curl -L https://github.com/rafa-mori/grompt/releases/latest/download/grompt_linux_amd64 -o grompt
chmod +x grompt
sudo mv grompt /usr/local/bin/

macOS

# macOS Intel
curl -L https://github.com/rafa-mori/grompt/releases/latest/download/grompt_darwin_amd64 -o grompt

# macOS Apple Silicon (M1/M2)
curl -L https://github.com/rafa-mori/grompt/releases/latest/download/grompt_darwin_arm64 -o grompt

# Tornar executável e mover para PATH
chmod +x grompt
sudo mv grompt /usr/local/bin/

Opção 2: Instalar via Make

git clone https://github.com/rafa-mori/grompt
cd grompt
make install

Este comando irá:

  1. Compilar o binário para sua plataforma
  2. Instalar em /usr/local/bin/grompt
  3. Tornar disponível globalmente

Opção 3: Compilar do Código Fonte

Pré-requisitos

Passos de Compilação

# 1. Clonar o repositório
git clone https://github.com/rafa-mori/grompt.git
cd grompt

# 2. Compilar
make build

# 3. Executar
./dist/grompt --help

Compilação para Outras Plataformas

# Compilar para Windows
make build-windows

# Compilar para Linux
make build-linux

# Compilar para macOS
make build-darwin

# Compilar para todas as plataformas
make build-all

⚙️ Configuração Inicial

1. Verificar Instalação

grompt --version

2. Configurar Variáveis de Ambiente (Opcional)

O Grompt funciona em modo demo sem configuração, mas para usar provedores de IA externos, configure as chaves de API:

# Adicione ao seu ~/.bashrc, ~/.zshrc, ou ~/.profile

# OpenAI
export OPENAI_API_KEY="sk-..."

# Claude (Anthropic)
export CLAUDE_API_KEY="sk-ant-..."

# DeepSeek
export DEEPSEEK_API_KEY="..."

# Gemini
export GEMINI_API_KEY="..."

# Ollama (local)
export OLLAMA_ENDPOINT="http://localhost:11434"

# Configurações do servidor (opcional)
export PORT=8080
export DEBUG=false

3. Primeiro Teste

# Testar em modo demo (sem API keys)
grompt

# Testar CLI
grompt ask "Olá mundo!" --provider demo

🔧 Configuração Avançada

Configuração do Servidor

Por padrão, o Grompt roda na porta 8080. Para alterar:

export PORT=3000
grompt

Ou diretamente:

grompt --port 3000

Configuração de Debug

Para habilitação de logs detalhados:

export DEBUG=true
grompt

Configuração para Ollama Local

Se você tem o Ollama instalado localmente:

# Instalar Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# Baixar um modelo
ollama pull llama2

# Configurar endpoint
export OLLAMA_ENDPOINT="http://localhost:11434"
export OLLAMA_MODEL="llama2"

🛠️ Solução de Problemas

Problemas Comuns

“Permission denied” no Linux/macOS

chmod +x grompt

“grompt: command not found”

Certifique-se que o binário está no PATH:

echo $PATH
which grompt

Porta já em uso

# Verificar qual processo usa a porta
lsof -i :8080

# Usar porta diferente
grompt --port 8081

Problemas de Firewall

# Linux: permitir porta no firewall
sudo ufw allow 8080

# macOS: permitir no firewall do sistema
# Vá em System Preferences > Security & Privacy > Firewall

Logs de Debug

DEBUG=true grompt

Testar Conectividade

# Testar se o servidor está rodando
curl http://localhost:8080/api/health

# Testar provedores de IA
grompt ask "teste" --provider openai --dry-run

📋 Requisitos do Sistema

Sistema Requisitos Mínimos
Memória RAM 100 MB
Espaço em Disco 50 MB
Processador x86_64 ou ARM64
Sistema Operacional Linux, macOS, Windows
Rede Conectividade com internet (para provedores de IA externos)

🔄 Atualizações

Verificar Versão Atual

grompt --version

Atualizar para Nova Versão

# Download manual
curl -L https://github.com/rafa-mori/grompt/releases/latest/download/grompt_linux_amd64 -o grompt-new
chmod +x grompt-new
sudo mv grompt-new /usr/local/bin/grompt

# Ou recompilar do código
cd grompt
git pull
make build
sudo cp dist/grompt /usr/local/bin/

📚 Próximos Passos