Twoody
Sviluppatori

I modelli del tuo computer, dal tuo codice

Twoody esegue un modello linguistico sul tuo computer. Il comando twoody lo usa da un terminale, e un'API compatibile con OpenAI lo mette a disposizione dei tuoi programmi, solo su questo computer e con una chiave.

  • Solo i modelli
  • Solo questo computer
  • Una chiave che puoi revocare
Terminal 
npm install -g twoody
twoody pull Qwen3.5-9B-Q4_K_M
twoody run Qwen3.5-9B-Q4_K_M "Riassumi questo testo in tre punti"

Senza l'app Twoody aperta, il comando avvia da solo Twoody Server in background; twoody stop lo ferma.

01

Installare il comando

Lo stesso comando, in qualunque modo lo installi.

Ovunque giri Node.js 22 o successivo: Mac, Windows, Linux.

npm 
npm install -g twoody

Su un Mac o su Linux, con Homebrew. Installa anche Node.js.

Homebrew 
brew install osmove/twoody/twoody

Per Python: il pacchetto avvia lo stesso comando e richiede Node.js 22 o successivo.

pip 
pipx install twoody

Twoody Server da solo, in un container, per un server, un NAS o un Raspberry Pi. L'API risponde all'indirizzo http://127.0.0.1:3000/v1, solo ai programmi di questo computer.

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 "il mio script"

In Twoody: Impostazioni › Sviluppatori › Installa il comando twoody.

Senza l'app

twoody serve avvia Twoody Server su questo computer, all'indirizzo http://127.0.0.1:3000. In un altro terminale, twoody api-key create crea una chiave; la prima volta ti rende anche proprietario del server, con il token di configurazione che il server ha lasciato nella sua cartella dei dati.

Twoody Server 
twoody serve
twoody api-key create "il mio script"

02

Eseguire un modello

twoody list mostra i modelli di questo computer, twoody pull ne installa uno dal catalogo di Twoody, twoody run risponde una volta o tiene una conversazione. Gli si può passare del testo con una pipe.

Terminal 
twoody list
twoody pull Qwen3.5-9B-Q4_K_M
twoody run Qwen3.5-9B-Q4_K_M "Riassumi questo testo in tre punti"
cat notes.txt | twoody run Qwen3.5-9B-Q4_K_M "Traduci in inglese:"
twoody api-key create "il mio script"

03

L'API compatibile con OpenAI

Crea una chiave con twoody api-key create o in Impostazioni › Sviluppatori. L'indirizzo è http://127.0.0.1:47821/v1 con l'app Twoody, http://127.0.0.1:3000/v1 con twoody serve. Risponde a /v1/models, /v1/chat/completions (in streaming o no) e /v1/embeddings.

  • GET /v1/models I modelli installati su questo computer
  • POST /v1/chat/completions Una risposta, in streaming o no
  • POST /v1/embeddings Vettori, quando è installato il modello di ricerca per significato
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": "Ciao"}]}'

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

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

04

Nel tuo editor o nel tuo agente

Qualsiasi strumento che accetti un indirizzo compatibile con OpenAI usa i modelli di Twoody. Per esempio:

Continue

Aggiungi questo modello all'elenco models del tuo 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

Nelle impostazioni di Cline, scegli il provider API OpenAI Compatible e compila questi quattro campi.

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

Dai ad Aider l'indirizzo di Twoody e la tua chiave, poi avvialo con il nome del modello preceduto da 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

Sostituisci twk_… con la tua chiave (twoody api-key create).

Impostazioni lette nella documentazione di ogni strumento il 30 ottobre 2026: Continue, Cline, Aider.

Che cosa dà l'API, e a chi

Solo i modelli: mai la tua memoria, i tuoi documenti o le tue conversazioni, che restano in Twoody. Risponde solo ai programmi di questo computer, mai alla rete né a una pagina web, e ognuno ha bisogno di una chiave che puoi revocare.

  • Solo i modelli
  • Solo questo computer
  • Una chiave che puoi revocare