Desarrolladores

Los modelos de tu ordenador, desde tu código

Twoody ejecuta un modelo de lenguaje en tu ordenador. El comando twoody lo usa desde un terminal, y una API compatible con OpenAI lo ofrece a tus programas, solo en este ordenador y con una clave.

Solo los modelos
Solo este ordenador
Una clave que puedes revocar

Terminal

npm install -g twoody
twoody pull Qwen3.5-9B-Q4_K_M
twoody run Qwen3.5-9B-Q4_K_M "Resume este texto en tres puntos"

Sin la app Twoody abierta, el comando inicia Twoody Server en segundo plano por sí solo; twoody stop lo detiene.

Instalar el comando

El mismo comando, lo instales como lo instales.

Donde funcione Node.js 22 o posterior: Mac, Windows, Linux.

npm

npm install -g twoody

En un Mac o en Linux, con Homebrew. Instala Node.js con él.

Homebrew

brew install osmove/twoody/twoody

Para Python: el paquete ejecuta el mismo comando y necesita Node.js 22 o posterior.

pip

pipx install twoody

Twoody Server solo, en un contenedor, para un servidor, un NAS o una Raspberry Pi. La API responde en http://127.0.0.1:3000/v1, solo a los programas de este ordenador.

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 "mi script"

En Twoody: Ajustes › Desarrolladores › Instalar el comando twoody.

Sin la app

twoody serve inicia Twoody Server en este ordenador, en http://127.0.0.1:3000. En otro terminal, twoody api-key create crea una clave; la primera vez también te hace propietario del servidor, con el token de configuración que el servidor dejó en su carpeta de datos.

Twoody Server

twoody serve
twoody api-key create "mi script"

Ejecutar un modelo

twoody list muestra los modelos de este ordenador, twoody pull instala uno del catálogo de Twoody, twoody run responde una vez o mantiene una conversación. Se le puede pasar texto por una tubería.

Terminal

twoody list
twoody pull Qwen3.5-9B-Q4_K_M
twoody run Qwen3.5-9B-Q4_K_M "Resume este texto en tres puntos"
cat notes.txt | twoody run Qwen3.5-9B-Q4_K_M "Traduce al inglés:"
twoody api-key create "mi script"

La API compatible con OpenAI

Crea una clave con twoody api-key create o en Ajustes › Desarrolladores. La dirección es http://127.0.0.1:47821/v1 con la app de Twoody, http://127.0.0.1:3000/v1 con twoody serve. Responde a /v1/models, /v1/chat/completions (en streaming o no) y /v1/embeddings.

GET /v1/models Los modelos instalados en este ordenador
POST /v1/chat/completions Una respuesta, en streaming o no
POST /v1/embeddings Vectores, cuando está instalado el modelo de búsqueda por significado

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": "Hola"}]}'

Python, con el paquete 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": "Hola"}],
)
print(answer.choices[0].message.content)

JavaScript, con el paquete 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: "Hola" }],
});
console.log(answer.choices[0].message.content);

En tu editor o tu agente

Cualquier herramienta que acepte una dirección compatible con OpenAI usa los modelos de Twoody. Por ejemplo:

Continue

Añade este modelo a la lista models de tu 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

En los ajustes de Cline, elige el proveedor de API OpenAI Compatible y rellena estos cuatro 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

Dale a Aider la dirección de Twoody y tu clave, y luego ejecútalo con el nombre del 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

Sustituye twk_… por tu clave (twoody api-key create).

Ajustes leídos en la documentación de cada herramienta el 30 de octubre de 2026: Continue, Cline, Aider.

Lo que da la API, y a quién

Solo los modelos: nunca tu memoria, tus documentos ni tus conversaciones, que se quedan en Twoody. Solo responde a los programas de este ordenador, nunca a la red ni a una página web, y cada uno necesita una clave que puedes revocar.

Solo los modelos
Solo este ordenador
Una clave que puedes revocar