Twoody
Entwickler

Die Modelle Ihres Computers, aus Ihrem Code

Twoody führt ein Sprachmodell auf Ihrem Computer aus. Der Befehl twoody nutzt es im Terminal, und eine OpenAI-kompatible API stellt es Ihren Programmen bereit, nur auf diesem Computer und mit einem Schlüssel.

  • Nur die Modelle
  • Nur dieser Computer
  • Ein widerrufbarer Schlüssel
Terminal 
npm install -g twoody
twoody pull Qwen3.5-9B-Q4_K_M
twoody run Qwen3.5-9B-Q4_K_M "Fasse diesen Text in drei Punkten zusammen"

Ist die Twoody-App nicht geöffnet, startet der Befehl Twoody Server selbst im Hintergrund; twoody stop beendet ihn.

01

Den Befehl installieren

Derselbe Befehl, egal wie Sie ihn installieren.

Überall, wo Node.js 22 oder neuer läuft: Mac, Windows, Linux.

npm 
npm install -g twoody

Auf einem Mac oder unter Linux, mit Homebrew. Node.js wird mitinstalliert.

Homebrew 
brew install osmove/twoody/twoody

Für Python: Das Paket startet denselben Befehl und braucht Node.js 22 oder neuer.

pip 
pipx install twoody

Twoody Server allein, in einem Container, für einen Server, ein NAS oder einen Raspberry Pi. Die API antwortet unter http://127.0.0.1:3000/v1, nur den Programmen dieses Computers.

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 "mein Skript"

In Twoody: Einstellungen › Entwickler › Befehl twoody installieren.

Ohne die App

twoody serve startet Twoody Server auf diesem Computer, unter http://127.0.0.1:3000. In einem anderen Terminal erstellt twoody api-key create einen Schlüssel; beim ersten Mal macht es Sie auch zum Eigentümer des Servers, mit dem Einrichtungstoken, das der Server in seinem Datenordner hinterlegt hat.

Twoody Server 
twoody serve
twoody api-key create "mein Skript"

02

Ein Modell ausführen

twoody list zeigt die Modelle auf diesem Computer, twoody pull installiert eines aus dem Katalog von Twoody, twoody run antwortet einmal oder führt eine Unterhaltung. Text kann per Pipe übergeben werden.

Terminal 
twoody list
twoody pull Qwen3.5-9B-Q4_K_M
twoody run Qwen3.5-9B-Q4_K_M "Fasse diesen Text in drei Punkten zusammen"
cat notes.txt | twoody run Qwen3.5-9B-Q4_K_M "Übersetze ins Englische:"
twoody api-key create "mein Skript"

03

Die OpenAI-kompatible API

Erstellen Sie einen Schlüssel mit twoody api-key create oder unter Einstellungen › Entwickler. Die Adresse ist http://127.0.0.1:47821/v1 mit der Twoody-App, http://127.0.0.1:3000/v1 mit twoody serve. Sie beantwortet /v1/models, /v1/chat/completions (gestreamt oder nicht) und /v1/embeddings.

  • GET /v1/models Die auf diesem Computer installierten Modelle
  • POST /v1/chat/completions Eine Antwort, gestreamt oder nicht
  • POST /v1/embeddings Vektoren, wenn das Modell für die Suche nach Bedeutung installiert ist
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, mit dem Paket 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, mit dem Paket 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 Ihrem Editor oder Agenten

Jedes Werkzeug, das eine OpenAI-kompatible Adresse annimmt, nutzt die Modelle von Twoody. Zum Beispiel:

Continue

Fügen Sie dieses Modell der Liste models Ihrer config.yaml hinzu.

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

Wählen Sie in den Einstellungen von Cline den API-Anbieter OpenAI Compatible und füllen Sie diese vier Felder aus.

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

Geben Sie Aider die Adresse von Twoody und Ihren Schlüssel, und starten Sie es dann mit dem Namen des Modells nach 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

Ersetzen Sie twk_… durch Ihren Schlüssel (twoody api-key create).

Einstellungen am 30. Oktober 2026 in der Dokumentation jedes Werkzeugs gelesen: Continue, Cline, Aider.

Was die API gibt, und wem

Nur die Modelle: nie Ihr Gedächtnis, Ihre Dokumente oder Unterhaltungen, die in Twoody bleiben. Sie antwortet nur Programmen dieses Computers, nie dem Netzwerk oder einer Webseite, und jedes braucht einen Schlüssel, den Sie widerrufen können.

  • Nur die Modelle
  • Nur dieser Computer
  • Ein widerrufbarer Schlüssel