Twoody
Desenvolvedores

Os modelos do seu computador, no seu código

O Twoody roda um modelo de linguagem no seu computador. O comando twoody o usa num terminal, e uma API compatível com a OpenAI o entrega aos seus programas, só neste computador e com uma chave.

  • Só os modelos
  • Só este computador
  • Uma chave que você pode revogar
Terminal 
npm install -g twoody
twoody pull Qwen3.5-9B-Q4_K_M
twoody run Qwen3.5-9B-Q4_K_M "Resuma este texto em três pontos"

Sem o app Twoody aberto, o comando inicia o Twoody Server em segundo plano sozinho; twoody stop o encerra.

01

Instalar o comando

O mesmo comando, seja qual for a forma de instalar.

Onde rodar o Node.js 22 ou mais recente: Mac, Windows, Linux.

npm 
npm install -g twoody

Em um Mac ou no Linux, com o Homebrew. Ele instala o Node.js junto.

Homebrew 
brew install osmove/twoody/twoody

Para Python: o pacote roda o mesmo comando e precisa do Node.js 22 ou mais recente.

pip 
pipx install twoody

O Twoody Server sozinho, em um contêiner, para um servidor, um NAS ou um Raspberry Pi. A API responde em http://127.0.0.1:3000/v1, só para os programas deste computador.

Docker 
docker run -d --init --name twoody -p 127.0.0.1:3000:3000 \
  -e TWOODY_API_ALLOW_NETWORK=1 -v twoody:/data ghcr.io/osmove/twoody-server
docker exec twoody twoody-server models add Qwen3.5-4B-Q4_K_M
docker exec twoody twoody-server api-key create "meu script"

No Twoody: Ajustes › Desenvolvedores › Instalar o comando twoody.

Sem o app

twoody serve inicia o Twoody Server neste computador, em http://127.0.0.1:3000. Em outro terminal, twoody api-key create cria uma chave; na primeira vez, também torna você o dono do servidor, com o token de configuração que o servidor deixou na pasta de dados.

Twoody Server 
twoody serve
twoody api-key create "meu script"

02

Rodar um modelo

twoody list mostra os modelos deste computador, twoody pull instala um do catálogo do Twoody, twoody run responde uma vez ou mantém uma conversa. Dá para enviar texto por um pipe.

Terminal 
twoody list
twoody pull Qwen3.5-9B-Q4_K_M
twoody run Qwen3.5-9B-Q4_K_M "Resuma este texto em três pontos"
cat notes.txt | twoody run Qwen3.5-9B-Q4_K_M "Traduza para o inglês:"
twoody api-key create "meu script"

03

A API compatível com a OpenAI

Crie uma chave com twoody api-key create ou em Ajustes › Desenvolvedores. O endereço é http://127.0.0.1:47821/v1 com o app Twoody, http://127.0.0.1:3000/v1 com twoody serve. Ela responde a /v1/models, /v1/chat/completions (em streaming ou não) e /v1/embeddings.

  • GET /v1/models Os modelos instalados neste computador
  • POST /v1/chat/completions Uma resposta, em streaming ou não
  • POST /v1/embeddings Vetores, quando o modelo de busca por significado está instalado
curl 
curl http://127.0.0.1:47821/v1/chat/completions \
  -H "Authorization: Bearer $TWOODY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "Qwen3.5-9B-Q4_K_M", "messages": [{"role": "user", "content": "Olá"}]}'

Python, com o pacote openai

Python 
from openai import OpenAI

client = OpenAI(base_url="http://127.0.0.1:47821/v1", api_key="twk_…")
answer = client.chat.completions.create(
    model="Qwen3.5-9B-Q4_K_M",
    messages=[{"role": "user", "content": "Olá"}],
)
print(answer.choices[0].message.content)

JavaScript, com o pacote openai

JavaScript 
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "http://127.0.0.1:47821/v1", apiKey: "twk_…" });
const answer = await client.chat.completions.create({
  model: "Qwen3.5-9B-Q4_K_M",
  messages: [{ role: "user", content: "Olá" }],
});
console.log(answer.choices[0].message.content);

04

No seu editor ou agente

Qualquer ferramenta que aceite um endereço compatível com a OpenAI usa os modelos do Twoody. Por exemplo:

Continue

Adicione este modelo à lista models do seu config.yaml.

config.yaml 
models:
  - name: Twoody
    provider: openai
    model: Qwen3.5-9B-Q4_K_M
    apiBase: http://127.0.0.1:47821/v1
    apiKey: twk_…

Cline

Nas configurações do Cline, escolha o provedor de API OpenAI Compatible e preencha estes quatro campos.

API Provider
OpenAI Compatible
Base URL
http://127.0.0.1:47821/v1
API Key
twk_…
Model ID
Qwen3.5-9B-Q4_K_M

Aider

Informe ao Aider o endereço do Twoody e sua chave, depois rode-o com o nome do modelo precedido de openai/.

Terminal 
export OPENAI_API_BASE=http://127.0.0.1:47821/v1
export OPENAI_API_KEY=twk_…
aider --model openai/Qwen3.5-9B-Q4_K_M

Substitua twk_… pela sua chave (twoody api-key create).

Ajustes lidos na documentação de cada ferramenta em 30 de outubro de 2026: Continue, Cline, Aider.

O que a API dá, e a quem

Só os modelos: nunca sua memória, seus documentos nem suas conversas, que ficam no Twoody. Ela só responde aos programas deste computador, nunca à rede nem a uma página da web, e cada um precisa de uma chave que você pode revogar.

  • Só os modelos
  • Só este computador
  • Uma chave que você pode revogar