Instalar o Lampson
Uma linha. Ele traz tudo de que precisa. Escolha como prefere instalar — a aba do seu sistema já está selecionada.
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 lampsonPara atualizar depois, é o mesmo comando com @latest. Suas configurações e sessões são mantidas.
Abrir um projeto
cd path/to/your/projectlampsonou lampson --web para a versão no navegador
Escolher um modelo
Na primeira vez, o Lampson pergunta qual provedor você usa e pede sua chave de API. Só isso — comece a digitar.
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 | iexPrefere npm? npm i -g lampson também funciona se você tem Node.js.
Abrir um projeto
Abra uma janela nova do terminal, vá até um projeto e inicie.
cd C:\path\to\your\projectlampsonou lampson --web para a versão no navegador
Escolher um modelo
Na primeira vez, o Lampson pergunta qual provedor você usa e pede sua chave de API. Só isso — comece a digitar.
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.
Abrir um projeto
Abra uma janela nova do terminal, vá até um projeto e inicie.
cd ~/path/to/your/projectlampsonou lampson --web para a versão no navegador
Escolher um modelo
Na primeira vez, o Lampson pergunta qual provedor você usa e pede sua chave de API. Só isso — comece a digitar.
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.
Abrir um projeto
Abra um terminal novo, vá até um projeto e inicie.
cd ~/path/to/your/projectlampsonou lampson --web para a versão no navegador
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.
| Provedor | Onde obter uma chave |
|---|---|
| DeepSeek | platform.deepseek.com |
| Anthropic | console.anthropic.com |
| OpenAI | platform.openai.com |
| GLM (Z.ai) | z.ai/model-api |
| Kimi (Moonshot) | platform.moonshot.ai |
| Groq | console.groq.com |
| OpenRouter | openrouter.ai — uma chave, muitos modelos |
| Ollama | sem chave — instale o Ollama 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@latestinstalou 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.
A partir do código-fonte
O Lampson é um conjunto de programas em Synsema — 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 ~/lampsonTodas as versões
Todas as versões, com suas mudanças, estão no GitHub Releases e no npm.
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.
- 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 — uma descrição curta e o seu sistema operacional bastam.