โฌ๏ธ Instalar o Ollama
Chega de teoria โ agora a gente instala. O Ollama e o programa que baixa, gerencia e roda modelos de IA na sua maquina. Neste modulo voce pega ele no site oficial, instala num unico comando (Mac/Linux) ou pelo instalador (Windows), e confere que esta tudo de pe. Os comandos sao reais e prontos pra colar.
๐ Pegar o Ollama no site oficial
Tudo comeca em ollama.com. La voce encontra o botao Download โ que detecta o seu sistema (Mac, Windows ou Linux) โ e, logo abaixo, o comando de instalacao por terminal. Sempre pegue o Ollama dessa fonte oficial: assim voce evita versoes falsas e garante o instalador certo pra sua maquina.
๐งญ O que voce vai achar na pagina
- โขBotao Download que ja sugere a versao do seu sistema operacional.
- โขO comando de instalacao por terminal (Mac/Linux), pronto pra copiar.
- โขUm catalogo de modelos para baixar depois (Qwen, Gemma, Mistral, etc.).
Novo aqui? "Instalar" e copiar o programa pro seu computador. "Terminal" e a janela onde voce digita comandos de texto (no Mac chama Terminal, no Windows pode ser o PowerShell). Voce nao precisa ser programador โ vai apenas colar comandos prontos.
Conceitos-chave
Sempre ollama.com โ evita instaladores falsos.
O botao detecta o seu sistema operacional.
Instalador grafico ou comando de terminal.
Lista de modelos abertos pra baixar depois.
๐ป Instalar via terminal (Mac / Linux)
No Mac e no Linux, a forma mais rapida e um unico comando. Ele baixa o script oficial de instalacao e o executa de uma vez. E exatamente o que aparece no site โ copie, cole no terminal e aperte Enter.
curl -fsSL https://ollama.com/install.sh | sh
ollama --version
๐ก O que o comando faz, em portugues
curl baixa um arquivo da internet; -fsSL sao opcoes que o deixam silencioso e seguro; o | sh manda esse arquivo direto pro shell executar. Em resumo: "baixe o instalador oficial e rode".
Conceitos-chave
Baixa o script de instalacao da internet.
Manda o script pro shell executar na hora.
Sem clicar em telas โ colou, rodou, instalou.
Confirma que a instalacao deu certo.
๐ช Windows e Mac: o instalador grafico
Nao curte terminal? Sem problema. No Windows (e tambem no Mac) da pra baixar o instalador pelo botao Download e instalar clicando, como qualquer outro programa. No fim, o Ollama fica rodando em segundo plano โ um icone discreto na bandeja/menu.
๐ช Windows
- 1.Clique em Download no site e baixe o instalador.
- 2.Execute o arquivo e siga o assistente.
- 3.O Ollama passa a rodar como servico em segundo plano.
๐ Mac (app)
- 1.Baixe o app do Ollama pelo botao Download.
- 2.Arraste pra pasta Aplicativos e abra.
- 3.O icone aparece na barra de menu, no topo.
Dica: mesmo instalando pelo app, voce ganha tambem os comandos de terminal (ollama ...) de brinde. Eles fazem parte do mesmo pacote โ entao da pra usar o app no dia a dia e o terminal quando precisar de algo mais avancado.
Conceitos-chave
Instalar clicando, sem linha de comando.
O Ollama fica rodando discreto, sempre pronto.
Acesso rapido pelo menu/bandeja do sistema.
Instalar o app ja traz os comandos tambem.
โ Conferir a instalacao
Antes de seguir pro proximo modulo, confirme que o Ollama esta de pe. Dois comandos resolvem: um mostra a versao (prova que ele esta instalado) e o outro lista os modelos baixados (que ainda vai estar vazio โ e isso e esperado).
ollama --version
ollama list
ollama version is 0.x.x. O segundo mostra uma tabela vazia (ou so o cabecalho) โ normal, porque voce ainda nao baixou nenhum modelo. Se os dois rodarem sem "command not found", esta tudo certo.Rode ollama --version
Imprimiu um numero de versao? Entao o programa esta instalado.
Rode ollama list
Lista vazia = tudo certo. Voce baixa o primeiro modelo no modulo 2.3.
Sem erro? Seguir em frente
Se aparecer "command not found", pule pro topico 6 (Deu errado?).
Conceitos-chave
Prova que o Ollama esta instalado.
Esperado no comeco โ nenhum modelo ainda.
Confirmar agora evita dor de cabeca depois.
Sinal de problema de PATH โ ver topico 6.
๐งฐ O app vs o terminal: dois caminhos, um motor
O Ollama tem duas caras: uma janela de aplicativo (com botoes e chat) e os comandos de terminal (ollama ...). Os dois falam com o mesmo programa rodando por baixo โ entao nao existe "jeito certo": use o que for mais confortavel pra voce.
As duas interfaces โ app e terminal โ convergem no mesmo motor do Ollama, que carrega o modelo local. Trocar de interface nao muda o resultado: e so o jeito de digitar.
Quando usar cada um? O app e otimo pra conversar e testar modelos com o mouse. O terminal brilha pra automatizar, baixar modelos e โ mais a frente โ criar o modelo de 64k do agente (modulo 2.4).
Conceitos-chave
Janela grafica versus linha de comando.
Os dois falam com o mesmo servico local.
Confortavel pra testar com o mouse.
Automacao e comandos avancados.
๐ Deu errado? Os ajustes mais comuns
O susto mais comum e instalar o Ollama e o terminal dizer command not found. Quase sempre nao e a instalacao que falhou โ e o terminal que ainda nao "enxerga" o comando novo. Aqui estao os ajustes que resolvem a grande maioria dos casos.
โ Tente primeiro
- โReabra o terminal โ feche a janela e abra outra; ela carrega o PATH novo.
- โNo Windows, abra um novo PowerShell depois de instalar.
- โConfirme com
ollama --versionna janela nova. - โSe instalou pelo app, verifique se ele esta aberto/rodando.
โ Erros tipicos
- โ
command not foundโ o terminal antigo nao tem o PATH atualizado. - โEsquecer de reabrir o terminal depois de instalar.
- โBaixar de um site nao oficial e pegar versao errada.
- โAchar que "travou" no 1o uso (e so o modelo carregando).
Novo aqui? "PATH" e a lista de pastas onde o terminal procura os comandos que voce digita. Quando o Ollama e instalado, ele se adiciona a essa lista โ mas a janela que ja estava aberta nao "sabe" disso. Reabrir o terminal resolve.
Conceitos-chave
Onde o terminal procura os comandos.
Carrega o PATH novo โ resolve a maioria.
Uma janela nova ja enxerga o ollama.
No app, ele precisa estar aberto/ativo.
Auto-checagem (opcional): qual e o comando para instalar o Ollama no Mac/Linux pelo terminal?
๐ฏ Resumo do modulo
curl -fsSL https://ollama.com/install.sh | sh.ollama --version e ollama list (lista vazia e normal).Proximo modulo:
2.2 โ Escolher o modelo certo pro seu hardware