MODULO 2.1

โฌ‡๏ธ 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.

6
Topicos
~30
Minutos
Basico
Nivel
Pratico
Tipo
1

๐ŸŒ 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.

Site ollama.com mostrando o botao Download e o comando curl de instalacao por terminal
O site oficial do Ollama: repare em dois caminhos na mesma pagina โ€” o botao Download (instalador grafico) e o comando de terminal logo abaixo. Voce escolhe um; os dois instalam o mesmo programa.

๐Ÿงญ 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

Fonte oficial

Sempre ollama.com โ€” evita instaladores falsos.

Download

O botao detecta o seu sistema operacional.

Dois caminhos

Instalador grafico ou comando de terminal.

Catalogo de modelos

Lista de modelos abertos pra baixar depois.

2

๐Ÿ’ป 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.

๐ŸŽฏObjetivo:instalar o Ollama no Mac/Linux com um comando so.
curl -fsSL https://ollama.com/install.sh | sh
Como verificar: quando terminar, rode o comando abaixo e veja se ele imprime um numero de versao:
ollama --version
Terminal executando o comando curl de instalacao do Ollama
O terminal rodando o instalador: voce cola a linha, da Enter, e o script faz o resto. Olhe as mensagens de progresso โ€” quando ele termina sem erro vermelho, o Ollama ja esta no seu sistema.

๐Ÿ’ก 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

curl

Baixa o script de instalacao da internet.

| sh

Manda o script pro shell executar na hora.

Um comando

Sem clicar em telas โ€” colou, rodou, instalou.

ollama --version

Confirma que a instalacao deu certo.

3

๐ŸชŸ 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

Instalador grafico

Instalar clicando, sem linha de comando.

Servico em segundo plano

O Ollama fica rodando discreto, sempre pronto.

Icone na bandeja

Acesso rapido pelo menu/bandeja do sistema.

App + terminal juntos

Instalar o app ja traz os comandos tambem.

4

โœ… 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).

๐ŸŽฏObjetivo:confirmar que o Ollama esta instalado e respondendo.
ollama --version
ollama list
Como verificar: o primeiro imprime algo como 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.
1

Rode ollama --version

Imprimiu um numero de versao? Entao o programa esta instalado.

2

Rode ollama list

Lista vazia = tudo certo. Voce baixa o primeiro modelo no modulo 2.3.

3

Sem erro? Seguir em frente

Se aparecer "command not found", pule pro topico 6 (Deu errado?).

Conceitos-chave

--version

Prova que o Ollama esta instalado.

list vazia

Esperado no comeco โ€” nenhum modelo ainda.

Verificar antes

Confirmar agora evita dor de cabeca depois.

command not found

Sinal de problema de PATH โ€” ver topico 6.

5

๐Ÿงฐ 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.

App (janela)botoes + chat Terminalollama ... Motor do Ollamaservico local modelo localna sua maquina

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

GUI vs CLI

Janela grafica versus linha de comando.

Mesmo motor

Os dois falam com o mesmo servico local.

App p/ conversar

Confortavel pra testar com o mouse.

Terminal p/ poder

Automacao e comandos avancados.

6

๐Ÿ†˜ 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 --version na 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

PATH

Onde o terminal procura os comandos.

Reabrir o terminal

Carrega o PATH novo โ€” resolve a maioria.

Sessao nova

Uma janela nova ja enxerga o ollama.

App rodando

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

โœ“
Fonte oficial โ€” sempre instale o Ollama a partir de ollama.com.
โœ“
Um comando (Mac/Linux) โ€” curl -fsSL https://ollama.com/install.sh | sh.
โœ“
Conferir โ€” ollama --version e ollama list (lista vazia e normal).
โœ“
Deu errado? โ€” reabra o terminal pra carregar o PATH novo.

Proximo modulo:

2.2 โ€” Escolher o modelo certo pro seu hardware