Twoody
Développeurs

Les modèles de votre ordinateur, depuis votre code

Twoody fait tourner un modèle de langage sur votre ordinateur. La commande twoody le fait tourner depuis un terminal, et une API compatible OpenAI le donne à vos programmes, sur cet ordinateur seulement, avec une clé.

  • Les modèles seulement
  • Cet ordinateur seulement
  • Une clé révocable
Terminal 
npm install -g twoody
twoody pull Qwen3.5-9B-Q4_K_M
twoody run Qwen3.5-9B-Q4_K_M "Résume ce texte en trois points"

Sans l'app Twoody ouverte, la commande démarre Twoody Server en arrière-plan toute seule ; twoody stop l'arrête.

01

Installer la commande

La même commande, quelle que soit la façon de l'installer.

Partout où tourne Node.js 22 ou plus : Mac, Windows, Linux.

npm 
npm install -g twoody

Sur un Mac ou sous Linux, avec Homebrew. Node.js est installé avec.

Homebrew 
brew install osmove/twoody/twoody

Pour Python : le paquet lance la même commande, et demande Node.js 22 ou plus.

pip 
pipx install twoody

Twoody Server seul, dans un conteneur, pour un serveur, un NAS ou un Raspberry Pi. L'API répond à l'adresse http://127.0.0.1:3000/v1, aux programmes de cet ordinateur seulement.

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

Dans Twoody : Réglages › Développeurs › Installer la commande twoody.

Sans l'app

twoody serve démarre Twoody Server sur cet ordinateur, à l'adresse http://127.0.0.1:3000. Dans un autre terminal, twoody api-key create fait une clé ; la première fois, elle fait aussi de vous le propriétaire du serveur, avec le jeton de configuration qu'il a laissé dans son dossier de données.

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

02

Faire tourner un modèle

twoody list montre les modèles de cet ordinateur, twoody pull en installe un du catalogue de Twoody, twoody run répond une fois ou tient une conversation. Un texte peut lui être envoyé par un tuyau.

Terminal 
twoody list
twoody pull Qwen3.5-9B-Q4_K_M
twoody run Qwen3.5-9B-Q4_K_M "Résume ce texte en trois points"
cat notes.txt | twoody run Qwen3.5-9B-Q4_K_M "Traduis en anglais :"
twoody api-key create "mon script"

03

L'API compatible OpenAI

Créez une clé avec twoody api-key create, ou dans Réglages › Développeurs. L'adresse est http://127.0.0.1:47821/v1 avec l'app Twoody, http://127.0.0.1:3000/v1 avec twoody serve. Elle répond à /v1/models, /v1/chat/completions (en flux ou non) et /v1/embeddings.

  • GET /v1/models Les modèles installés sur cet ordinateur
  • POST /v1/chat/completions Une réponse, en flux ou non
  • POST /v1/embeddings Des vecteurs, quand le modèle de recherche par le sens est installé
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": "Bonjour"}]}'

Python, avec le paquet 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": "Bonjour"}],
)
print(answer.choices[0].message.content)

JavaScript, avec le paquet 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: "Bonjour" }],
});
console.log(answer.choices[0].message.content);

04

Dans votre éditeur ou votre agent

Tout outil qui accepte une adresse compatible OpenAI utilise les modèles de Twoody. Par exemple :

Continue

Ajoutez ce modèle à la liste models de votre 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

Dans les réglages de Cline, choisissez le fournisseur d'API OpenAI Compatible et remplissez ces quatre champs.

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

Donnez à Aider l'adresse de Twoody et votre clé, puis lancez-le avec le nom du modèle précédé 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

Remplacez twk_… par votre clé (twoody api-key create).

Réglages lus dans la documentation de chaque outil le 30 octobre 2026 : Continue, Cline, Aider.

Ce que l'API donne, et à qui

Les modèles seulement : jamais votre mémoire, vos documents ni vos conversations, qui restent dans Twoody. Elle ne répond qu'aux programmes de cet ordinateur, jamais au réseau ni à une page web, et chacun a besoin d'une clé que vous pouvez révoquer.

  • Les modèles seulement
  • Cet ordinateur seulement
  • Une clé révocable