Twoody
Ontwikkelaars

De modellen van uw computer, vanuit uw code

Twoody draait een taalmodel op uw computer. De opdracht twoody gebruikt het in een terminal, en een OpenAI-compatibele API geeft het aan uw programma's, alleen op deze computer en met een sleutel.

  • Alleen de modellen
  • Alleen deze computer
  • Een sleutel die u kunt intrekken
Terminal 
npm install -g twoody
twoody pull Qwen3.5-9B-Q4_K_M
twoody run Qwen3.5-9B-Q4_K_M "Vat deze tekst samen in drie punten"

01

De opdracht installeren

Dezelfde opdracht, hoe u hem ook installeert.

Overal waar Node.js 22 of nieuwer draait: Mac, Windows, Linux.

npm 
npm install -g twoody

Op een Mac of onder Linux, met Homebrew. Node.js wordt meegeïnstalleerd.

Homebrew 
brew install osmove/twoody/twoody

Voor Python: het pakket start dezelfde opdracht en heeft Node.js 22 of nieuwer nodig.

pip 
pipx install twoody

Twoody Server alleen, in een container, voor een server, een NAS of een Raspberry Pi. De API antwoordt op http://127.0.0.1:3000/v1, alleen aan de programma's van deze 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 "mijn script"

In Twoody: Instellingen › Ontwikkelaars › Opdracht twoody installeren.

Zonder de app

twoody serve start Twoody Server op deze computer, op http://127.0.0.1:3000. In een andere terminal maakt twoody api-key create een sleutel; de eerste keer maakt het u ook eigenaar van de server, met het installatietoken dat de server in zijn gegevensmap heeft gezet.

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

02

Een model draaien

twoody list toont de modellen op deze computer, twoody pull installeert er een uit de catalogus van Twoody, twoody run antwoordt één keer of voert een gesprek. Tekst kan via een pipe worden doorgegeven.

Terminal 
twoody list
twoody pull Qwen3.5-9B-Q4_K_M
twoody run Qwen3.5-9B-Q4_K_M "Vat deze tekst samen in drie punten"
cat notes.txt | twoody run Qwen3.5-9B-Q4_K_M "Vertaal naar het Engels:"
twoody api-key create "mijn script"

03

De OpenAI-compatibele API

Maak een sleutel met twoody api-key create of in Instellingen › Ontwikkelaars. Het adres is http://127.0.0.1:47821/v1 met de Twoody-app, http://127.0.0.1:3000/v1 met twoody serve. Hij beantwoordt /v1/models, /v1/chat/completions (gestreamd of niet) en /v1/embeddings.

  • GET /v1/models De modellen die op deze computer zijn geïnstalleerd
  • POST /v1/chat/completions Een antwoord, gestreamd of niet
  • POST /v1/embeddings Vectoren, als het model voor zoeken op betekenis is geïnstalleerd
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": "Hallo"}]}'

Python, met het pakket 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": "Hallo"}],
)
print(answer.choices[0].message.content)

JavaScript, met het pakket 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: "Hallo" }],
});
console.log(answer.choices[0].message.content);

04

In uw editor of agent

Elk hulpmiddel dat een OpenAI-compatibel adres aanneemt, gebruikt de modellen van Twoody. Bijvoorbeeld:

Continue

Voeg dit model toe aan de lijst models van uw 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

Kies in de instellingen van Cline de API-provider OpenAI Compatible en vul deze vier velden in.

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

Geef Aider het adres van Twoody en uw sleutel, en start het dan met de naam van het model na 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

Vervang twk_… door uw sleutel (twoody api-key create).

Instellingen op 30 oktober 2026 gelezen in de documentatie van elk hulpmiddel: Continue, Cline, Aider.

Wat de API geeft, en aan wie

Alleen de modellen: nooit uw geheugen, documenten of gesprekken, die in Twoody blijven. Hij antwoordt alleen programma's op deze computer, nooit het netwerk of een webpagina, en elk programma heeft een sleutel nodig die u kunt intrekken.

  • Alleen de modellen
  • Alleen deze computer
  • Een sleutel die u kunt intrekken