Quando alguém fala "a IA", quase sempre está falando de duas coisas misturadas. Uma é o modelo, o cérebro que lê o texto e responde. A outra é tudo que fica em volta dele: as ferramentas que ele pode usar, a memória da conversa, o passo a passo de uma tarefa longa e as regras do que ele pode ou não mexer no seu computador. Essa segunda parte tem nome: harness.
A analogia mais simples é a do carro. O modelo é o motor. O harness é o carro inteiro em volta: volante, freio, câmbio, painel. Um motor potente solto no chão não leva ninguém a lugar nenhum. É o carro que transforma força em viagem, e por isso dois produtos com o mesmo modelo podem se comportar de jeitos completamente diferentes.
O DeepSeek Harness é o harness que a DeepSeek abriu como código aberto, sob licença MIT. Ele roda no seu computador e aceita qualquer motor: o da própria DeepSeek, o da OpenAI, o da Anthropic ou um modelo rodando na sua máquina. Este guia mostra o que ele faz, como rodar e com que cuidado.
Os números (conferidos em 04/10/2026)
- Repositório: https://github.com/deepseek-ai/deepseek-harness
- Estrelas no GitHub: 243.335, medidas pela API do GitHub.
- Criado em: 13/08/2026, menos de dois meses antes desta conferência.
- Licença: MIT, ou seja, uso livre, inclusive comercial.
Você vai achar por aí números como "95 mil estrelas em dois dias". Eles vêm de artigo sem fonte primária, por isso não entram aqui.
O que o harness faz pelo modelo
- Ferramentas. Dá ao modelo a capacidade de ler arquivo, rodar comando, buscar na web. Sem isso, ele só conversa.
- Memória. Guarda o que já foi dito e feito, para a tarefa não recomeçar do zero a cada mensagem.
- Passo a passo. Quebra uma tarefa grande em etapas e acompanha cada uma.
- Permissões. Decide o que a IA pode tocar no seu computador e o que precisa da sua autorização.
"Tudo é plugin"
O slogan oficial do projeto é "Everything is a Plugin". Cada peça (ferramenta, memória, provedor de modelo, interface) é um plugin trocável, construído sobre o framework Cordis. Na prática: se uma peça não serve, você troca só ela, sem mexer no resto.
Como rodar no seu computador
Precisa do Node.js instalado. No terminal:
npx @deepseek-ai/dsh web
Isso abre uma interface no navegador, em http://127.0.0.1:3080. O endereço 127.0.0.1 significa "só esta máquina": a interface não fica exposta na internet.
Trocando o motor
Ele vem ligado à API da DeepSeek, mas na configuração de provedor você aponta para outro:
- OpenAI ou Anthropic (Claude), com a chave de API de cada uma.
- Qualquer serviço compatível com a API da OpenAI.
- Modelo local via Ollama, rodando na sua própria máquina.
Sobre custo: o software é de graça. O modelo na nuvem é cobrado à parte, pela empresa dona dele. Só o modelo local roda sem custo de API, e nesse caso quem paga é o seu computador, em memória e processamento.
Os cuidados: é prévia, e já teve falha grave
O próprio README chama o projeto de developer preview e avisa que vai haver mudanças que quebram compatibilidade. Traduzindo: o que funciona hoje pode parar de funcionar na próxima versão.
E já houve falha séria. A CVE-2026-82533, com nota 9,4 de 10, permitia fugir do sandbox, a caixa isolada onde a IA deveria ficar presa. Ela foi corrigida na versão 0.1.2-alpha.1, em 27/08/2026.
O que fazer:
- Mantenha sempre atualizado. Com
npx @deepseek-ai/dsh, onpxbusca a versão publicada; confira de vez em quando qual versão está rodando. - Leia o
SAFETY.mddo repositório antes de dar acesso a pastas importantes. - Comece numa pasta de teste, sem documentos pessoais nem chaves de acesso por perto.
- Não use em produção enquanto o projeto se apresentar como prévia.