# Instalar o Lampson — npm, Windows, macOS, Linux > Versão Markdown de https://lampson.org/pt/install — a mesma página que um navegador exibe como HTML. # Instalar o Lampson Uma linha. Ele traz tudo de que precisa. Escolha como prefere instalar — a aba do seu sistema já está selecionada. 1 ### Instalar Se você tem Node.js (18 ou mais recente), este é o jeito mais fácil. Funciona no Windows, macOS e Linux. $`npm i -g lampson` Para atualizar depois, é o mesmo comando com `@latest`. Suas configurações e sessões são mantidas. 2 ### Abrir um projeto $`cd path/to/your/project` $`lampson` ou `lampson --web` para a versão no navegador 3 ### Escolher um modelo Na primeira vez, o Lampson pergunta qual provedor você usa e pede sua chave de API. Só isso — comece a digitar. 1 ### Instalar Abra o **PowerShell** e cole esta linha. Ela instala o que estiver faltando (o Git para Windows, se você não tiver — ele vai perguntar), coloca o Lampson na sua pasta de usuário e o adiciona ao PATH. >`irm https://raw.githubusercontent.com/kitecosmic/lampson/main/install.ps1 | iex` Prefere npm? `npm i -g lampson` também funciona se você tem Node.js. 2 ### Abrir um projeto Abra uma janela **nova** do terminal, vá até um projeto e inicie. >`cd C:\path\to\your\project` >`lampson` ou `lampson --web` para a versão no navegador 3 ### Escolher um modelo Na primeira vez, o Lampson pergunta qual provedor você usa e pede sua chave de API. Só isso — comece a digitar. 1 ### Instalar Abra o **Terminal** e cole esta linha. Ela instala o que estiver faltando, coloca o Lampson em `~/lampson` e cria o link do comando no seu PATH. $`bash -c "$(curl -fsSL https://raw.githubusercontent.com/kitecosmic/lampson/main/install.sh)"` Prefere npm? `npm i -g lampson` também funciona se você tem Node.js. 2 ### Abrir um projeto Abra uma janela **nova** do terminal, vá até um projeto e inicie. $`cd ~/path/to/your/project` $`lampson` ou `lampson --web` para a versão no navegador 3 ### Escolher um modelo Na primeira vez, o Lampson pergunta qual provedor você usa e pede sua chave de API. Só isso — comece a digitar. 1 ### Instalar Cole esta linha no seu shell. Ela instala o que estiver faltando, coloca o Lampson em `~/lampson` e cria o link do comando em `~/.local/bin`. $`bash -c "$(curl -fsSL https://raw.githubusercontent.com/kitecosmic/lampson/main/install.sh)"` Precisa de uma distribuição recente (Ubuntu 24.04+, Debian 13+, Fedora 40+). Prefere npm? `npm i -g lampson` também funciona. 2 ### Abrir um projeto Abra um terminal **novo**, vá até um projeto e inicie. $`cd ~/path/to/your/project` $`lampson` ou `lampson --web` para a versão no navegador 3 ### Escolher um modelo Na primeira vez, o Lampson pergunta qual provedor você usa e pede sua chave de API. Só isso — comece a digitar. ## Qual modelo devo usar? Qualquer um destes. Se você não tem um favorito, o **DeepSeek** é barato e funciona muito bem; o **Ollama** roda um modelo na sua própria máquina, sem chave nenhuma. ProvedorOnde obter uma chave DeepSeek[platform.deepseek.com](https://platform.deepseek.com) Anthropic[console.anthropic.com](https://console.anthropic.com) OpenAI[platform.openai.com](https://platform.openai.com) GLM (Z.ai)[z.ai/model-api](https://z.ai/model-api) Kimi (Moonshot)[platform.moonshot.ai](https://platform.moonshot.ai) Groq[console.groq.com](https://console.groq.com) OpenRouter[openrouter.ai](https://openrouter.ai) — uma chave, muitos modelos Ollamasem chave — [instale o Ollama](https://ollama.com) e baixe um modelo Você pode trocar de provedor ou de modelo a qualquer momento: digite `/model` no terminal ou clique no nome do modelo no cabeçalho da versão web. ## Atualizar O Lampson avisa quando existe uma versão mais nova. Então: $`npm i -g lampson@latest` instalou com o instalador de uma linha? rode `lampson --update` em vez disso ## Outras formas Docker O agente inteiro — inclusive os comandos que ele executa — fica dentro de um contêiner. Monte seu projeto como espaço de trabalho (workspace): ``` docker run --rm -p 8080:8080 -v "$PWD:/lampson/workspace" \ -e LAMPSON_PROVIDER=deepseek -e LAMPSON_API_KEY=sk-... ghcr.io/kitecosmic/lampson ``` Depois abra [http://127.0.0.1:8080](http://127.0.0.1:8080). A partir do código-fonte O Lampson é um conjunto de programas em [Synsema](https://synsema.org) — sem etapa de build. Clone o repositório, instale o Synsema e rode `./lampson.sh` (ou `lampson.ps1` no Windows) a partir da pasta de um projeto. $`git clone https://github.com/kitecosmic/lampson.git ~/lampson` Todas as versões Todas as versões, com suas mudanças, estão no [GitHub Releases](https://github.com/kitecosmic/lampson/releases) e no [npm](https://www.npmjs.com/package/lampson). ## Algo não funcionou? - **“lampson: command not found”** logo depois de instalar — abra uma janela nova do terminal; a mudança no PATH só vale para janelas novas. - **Windows: ele pede o Git** — o Lampson usa o bash do Git para executar comandos. Diga sim ao instalador ou baixe em [gitforwindows.org](https://gitforwindows.org). - **A interface web responde 401** — a versão web só responde ao seu próprio computador (localhost). Isso é de propósito. - Qualquer outra coisa: [abra uma issue](https://github.com/kitecosmic/lampson/issues) — uma descrição curta e o seu sistema operacional bastam.