modelmix 3.2.2 → 3.3.2

package/MODELS.md

@@ -0,0 +1,249 @@
+# ModelMix Provider Documentation
+
+This document describes how each model provider in ModelMix handles data input and output formats.
+
+## Common Structure
+
+All providers inherit from `MixCustom` base class which provides common functionality for:
+- API key management
+- Error handling
+- Basic request/response processing
+- Stream handling
+
+## Provider-Specific Details
+
+### OpenAI (MixOpenAI)
+- **Base URL**: `https://api.openai.com/v1/chat/completions`
+- **Input Format**:
+  ```json
+  {
+    "messages": [
+      {
+        "role": "system",
+        "content": "system message"
+      },
+      {
+        "role": "user",
+        "content": [
+          {
+            "type": "text",
+            "text": "message text"
+          },
+          {
+            "type": "image_url",
+            "image_url": {
+              "url": "data:image/jpeg;base64,..."
+            }
+          }
+        ]
+      }
+    ],
+    "model": "model-name",
+    "temperature": 1,
+    "max_tokens": 5000,
+    "top_p": 1
+  }
+  ```
+- **Output Format**:
+  ```json
+  {
+    "choices": [
+      {
+        "message": {
+          "content": "response text"
+        }
+      }
+    ]
+  }
+  ```
+- **Special Notes**: 
+  - Removes `max_tokens` and `temperature` for o1/o3 models
+  - Converts image messages to base64 data URLs
+
+### Anthropic (MixAnthropic)
+- **Base URL**: `https://api.anthropic.com/v1/messages`
+- **Input Format**:
+  ```json
+  {
+    "system": "system message",
+    "messages": [
+      {
+        "role": "user",
+        "content": [
+          {
+            "type": "text",
+            "text": "message text"
+          },
+          {
+            "type": "image",
+            "source": {
+              "type": "base64",
+              "media_type": "image/jpeg",
+              "data": "base64data"
+            }
+          }
+        ]
+      }
+    ],
+    "model": "claude-3-sonnet-20240229",
+    "temperature": 1,
+    "top_p": 1
+  }
+  ```
+- **Output Format**:
+  ```json
+  {
+    "content": [
+      {
+        "text": "response text"
+      }
+    ]
+  }
+  ```
+- **Special Notes**:
+  - Removes `top_p` when thinking mode is enabled
+  - Uses `x-api-key` header instead of `authorization`
+  - Requires `anthropic-version` header
+
+### Perplexity (MixPerplexity)
+- **Base URL**: `https://api.perplexity.ai/chat/completions`
+- **Input Format**: Same as OpenAI
+- **Output Format**: Same as OpenAI
+- **Special Notes**: Uses standard OpenAI-compatible format
+
+### Grok (MixGrok)
+- **Base URL**: `https://api.x.ai/v1/chat/completions`
+- **Input Format**: Same as OpenAI
+- **Output Format**: Same as OpenAI
+- **Special Notes**: Inherits from MixOpenAI
+
+### Together (MixTogether)
+- **Base URL**: `https://api.together.xyz/v1/chat/completions`
+- **Input Format**:
+  ```json
+  {
+    "messages": [
+      {
+        "role": "system",
+        "content": "system message"
+      },
+      {
+        "role": "user",
+        "content": "message text"
+      }
+    ],
+    "model": "model-name",
+    "stop": ["<|eot_id|>", "<|eom_id|>"]
+  }
+  ```
+- **Output Format**: Same as OpenAI
+- **Special Notes**: 
+  - Flattens content arrays to strings
+  - Adds default stop tokens
+
+### Google (MixGoogle)
+- **Base URL**: `https://generativelanguage.googleapis.com/v1beta/models`
+- **Input Format**:
+  ```json
+  {
+    "contents": [
+      {
+        "role": "user",
+        "parts": [
+          {
+            "text": "message text"
+          },
+          {
+            "inline_data": {
+              "mime_type": "image/jpeg",
+              "data": "base64data"
+            }
+          }
+        ]
+      }
+    ],
+    "generationConfig": {
+      "responseMimeType": "text/plain"
+    }
+  }
+  ```
+- **Output Format**:
+  ```json
+  {
+    "candidates": [
+      {
+        "content": {
+          "parts": [
+            {
+              "text": "response text"
+            }
+          ]
+        }
+      }
+    ]
+  }
+  ```
+- **Special Notes**:
+  - Uses different role names (`model` instead of `assistant`)
+  - Requires model ID in URL path
+  - Doesn't support streaming
+  - Available Gemini models:
+    - `gemini-2.5-flash-preview-04-17`
+    - `gemini-2.5-pro-exp-03-25`
+    - `gemini-2.5-pro-preview-05-06`
+  - Each model has different capabilities:
+    - Flash: Fastest response time, best for simple tasks
+    - Pro: More capable, better for complex tasks
+    - Pro Exp: Experimental version with latest features
+
+### Cerebras (MixCerebras)
+- **Base URL**: `https://api.cerebras.ai/v1/chat/completions`
+- **Input Format**: Same as Together
+- **Output Format**: Same as OpenAI
+- **Special Notes**: Uses Together's message conversion
+
+### Ollama (MixOllama)
+- **Base URL**: `http://localhost:11434/api/chat`
+- **Input Format**:
+  ```json
+  {
+    "messages": [
+      {
+        "role": "system",
+        "content": "system message",
+        "images": []
+      },
+      {
+        "role": "user",
+        "content": "message text",
+        "images": ["base64data"]
+      }
+    ]
+  }
+  ```
+- **Output Format**:
+  ```json
+  {
+    "message": {
+      "content": "response text"
+    }
+  }
+  ```
+- **Special Notes**: 
+  - Local deployment only
+  - Handles images in separate array
+  - No API key required
+
+### LM Studio (MixLMStudio)
+- **Base URL**: `http://localhost:1234/v1/chat/completions`
+- **Input Format**: Same as OpenAI
+- **Output Format**: Same as OpenAI
+- **Special Notes**: 
+  - Local deployment only
+  - No API key required
+
+### Groq (MixGroq)
+- **Base URL**: `https://api.groq.com/openai/v1/chat/completions`
+- **Input Format**: Same as OpenAI
+- **Output Format**: Same as OpenAI
+- **Special Notes**: Uses OpenAI-compatible format 

package/README.md

@@ -47,6 +47,16 @@ Here's a quick example to get you started:
 import 'dotenv/config';
 import { ModelMix } from 'modelmix';
 
+// Get structured JSON responses
+const model = ModelMix.new()
+    .sonnet37() // Anthropic claude-3-7-sonnet-20250219
+    .addText("Name and capital of 3 South American countries.");
+
+const outputExample = { countries: [{ name: "", capital: "" }] };
+console.log(await model.json(outputExample));
+```
+
+```javascript
 // Basic setup with system prompt and debug mode
 const setup = {
     config: {
@@ -56,24 +66,24 @@ const setup = {
 };
 
 // Chain multiple models with automatic fallback
-const result = await ModelMix.create(setup)
-    .sonnet37think()
-    .o4mini({ config: { temperature: 0 } })
-    .gemini25proExp()
-    .gpt41nano()
-    .grok3mini()
-    .addText("What's your name?")
-    .message();
-
-console.log(result);
+const model = await ModelMix.new(setup)
+    .sonnet37think() // (main model) Anthropic claude-3-7-sonnet-20250219
+    .o4mini() // (fallback 1) OpenAI o4-mini
+    .gemini25proExp({ config: { temperature: 0 } }) // (fallback 2) Google gemini-2.5-pro-exp-03-25
+    .gpt41nano() // (fallback 3) OpenAI gpt-4.1-nano
+    .grok3mini() // (fallback 4) Grok grok-3-mini-beta
+    .addText("What's your name?");
+
+console.log(await model.message());
+```
 
-// Get structured JSON responses
-const jsonResult = await ModelMix.create()
-    .sonnet37()
-    .addText("Name and capital of 3 South American countries.")
-    .json({ countries: [{ name: "", capital: "" }] });
+```javascript
 
-console.log(jsonResult);
+const ETH = ModelMix.new()
+  .sonar() // Perplexity sonar
+  .addText('How much is ETH trading in USD?')
+  .json({ price: 1000.1 });
+console.log(ETH.price);
 ```
 
 This pattern allows you to:
@@ -82,6 +92,53 @@ This pattern allows you to:
 - Get structured JSON responses when needed
 - Keep your code clean and maintainable
 
+## ⚡️ Shorthand Methods
+
+ModelMix provides convenient shorthand methods for quickly accessing different AI models. Here's a comprehensive list of available methods:
+
+| Method             | Provider   | Model                          | Price (I/O) per 1 M tokens |
+| ------------------ | ---------- | ------------------------------ | -------------------------- |
+| `gpt41()`          | OpenAI     | gpt-4.1                        | [\$2.00 / \$8.00][1]       |
+| `gpt41mini()`      | OpenAI     | gpt-4.1-mini                   | [\$0.40 / \$1.60][1]       |
+| `gpt41nano()`      | OpenAI     | gpt-4.1-nano                   | [\$0.10 / \$0.40][1]       |
+| `gpt4o()`          | OpenAI     | gpt-4o                         | [\$5.00 / \$20.00][1]      |
+| `o4mini()`         | OpenAI     | o4-mini                        | [\$1.10 / \$4.40][1]       |
+| `o3()`             | OpenAI     | o3                             | [\$10.00 / \$40.00][1]     |
+| `sonnet37()`       | Anthropic  | claude-3-7-sonnet-20250219     | [\$3.00 / \$15.00][2]      |
+| `sonnet37think()`  | Anthropic  | claude-3-7-sonnet-20250219     | [\$3.00 / \$15.00][2]      |
+| `sonnet35()`       | Anthropic  | claude-3-5-sonnet-20241022     | [\$3.00 / \$15.00][2]      |
+| `haiku35()`        | Anthropic  | claude-3-5-haiku-20241022      | [\$0.80 / \$4.00][2]       |
+| `gemini25flash()`   | Google     | gemini-2.5-flash-preview-04-17  | [\$0.00 / \$0.00][5]       |
+| `gemini25proExp()` | Google     | gemini-2.5-pro-exp-03-25       | [\$0.00 / \$0.00][5]       |
+| `gemini25pro()`    | Google     | gemini-2.5-pro-preview-05-06   | [\$2.50 / \$15.00][5]      |
+| `grok2()`          | Grok       | grok-2-latest                  | [\$2.00 / \$10.00][9]      |
+| `grok3()`          | Grok       | grok-3-beta                    | [\$3.00 / \$15.00][9]      |
+| `grok3mini()`      | Grok       | grok-3-mini-beta               | [\$0.30 / \$0.50][9]       |
+| `sonar()`          | Perplexity | sonar                          | [\$1.00 / \$1.00][7]       |
+| `sonarPro()`       | Perplexity | sonar-pro                      | [\$3.00 / \$15.00][7]      |
+| `qwen3()`          | Groq       | Qwen3-235B-A22B-fp8-tput       | [\$0.29 / \$0.39][8]       |
+| `scout()`          | Groq       | Llama-4-Scout-17B-16E-Instruct | [\$0.11 / \$0.34][8]       |
+| `maverick()`       | Groq       | Maverick-17B-128E-Instruct-FP8 | [\$0.20 / \$0.60][8]       |
+
+[1]: https://openai.com/api/pricing/ "Pricing | OpenAI"
+[2]: https://www.anthropic.com/pricing "Pricing - Anthropic"
+[5]: https://ai.google.dev/gemini-api/docs/pricing "Google AI for Developers"
+[7]: https://docs.perplexity.ai/guides/pricing "Pricing - Perplexity"
+[8]: https://groq.com/pricing/ "Groq Pricing"
+[9]: https://docs.x.ai/docs/models "xAI"
+
+Each method accepts optional `options` and `config` parameters to customize the model's behavior. For example:
+
+```javascript
+const result = await ModelMix.new({ 
+        options: { temperature: 0.7 },
+        config: { system: "You are a helpful assistant" }
+    })
+    .sonnet37()
+    .addText("Tell me a story about a cat");
+    .message();
+```
+
 ## 🔄 Templating Methods
 
 ### `replace` Method
@@ -90,7 +147,7 @@ The `replace` method is used to define key-value pairs for text replacement in t
 
 #### Usage:
 ```javascript
-gpt.replace({ '{{key1}}': 'value1', '{{key2}}': 'value2' });
+model.replace({ '{{key1}}': 'value1', '{{key2}}': 'value2' });
 ```
 
 #### How it works:
@@ -99,7 +156,7 @@ gpt.replace({ '{{key1}}': 'value1', '{{key2}}': 'value2' });
 
 #### Example:
 ```javascript
-gpt
+model
   .replace({ '{{name}}': 'Alice', '{{age}}': '30' })
   .addText('Hello {{name}}, are you {{age}} years old?');
 ```
@@ -111,7 +168,7 @@ The `replaceKeyFromFile` method is similar to `replace`, but it reads the replac
 
 #### Usage:
 ```javascript
-messageHandler.replaceKeyFromFile('longText', './path/to/file.txt');
+model.replaceKeyFromFile('longText', './path/to/file.txt');
 ```
 
 #### How it works:
@@ -139,7 +196,7 @@ To activate debug mode in ModelMix and view detailed request information, follow
 1. In the ModelMix constructor, include `debug: true` in the configuration:
 
    ```javascript
-   const mix = new ModelMix({
+   const mix = ModelMix.new({
      config: {
        debug: true
        // ... other configuration options ...
@@ -165,16 +222,16 @@ ModelMix now uses Bottleneck for efficient rate limiting of API requests. This i
 
 1. **Configuration**: Bottleneck is configured in the ModelMix constructor. You can customize the settings or use the default configuration:
 
-    ```javascript
-    const setup = {
-        config: {
-            bottleneck: {
-                maxConcurrent: 8,     // Maximum number of concurrent requests
-                minTime: 500          // Minimum time between requests (in ms)
-            }
+```javascript
+const setup = {
+    config: {
+        bottleneck: {
+            maxConcurrent: 8,     // Maximum number of concurrent requests
+            minTime: 500          // Minimum time between requests (in ms)
         }
-    };
-    ```
+    }
+};
+```
 
 2. **Rate Limiting**: When you make a request using any of the attached models, Bottleneck automatically manages the request flow based on the configured settings.
 
@@ -205,53 +262,12 @@ new ModelMix(args = { options: {}, config: {} })
       - `reservoirRefreshInterval`: Reservoir refresh interval
     - ...(Additional configuration parameters can be added as needed)
 
-### Shorthand Methods
-
-ModelMix provides convenient shorthand methods for quickly accessing different AI models. Here's a comprehensive list of available methods:
-
-| Method             | Provider    | Model                          | Description                                  |
-| ------------------ | ----------- | ------------------------------ | -------------------------------------------- |
-| `gpt41()`          | OpenAI      | gpt-4.1                        | OpenAI's GPT-4.1 model                       |
-| `gpt41mini()`      | OpenAI      | gpt-4.1-mini                   | OpenAI's GPT-4.1 Mini model                  |
-| `gpt41nano()`      | OpenAI      | gpt-4.1-nano                   | OpenAI's GPT-4.1 Nano model                  |
-| `gpt4o()`          | OpenAI      | gpt-4o                         | OpenAI's GPT-4 Optimized model               |
-| `o4mini()`         | OpenAI      | o4-mini                        | OpenAI's O4 Mini model                       |
-| `o3()`             | OpenAI      | o3                             | OpenAI's O3 model                            |
-| `sonnet37()`       | Anthropic   | claude-3-7-sonnet-20250219     | Anthropic's Claude 3.7 Sonnet model          |
-| `sonnet37think()`  | Anthropic   | claude-3-7-sonnet-20250219     | Claude 3.7 Sonnet with thinking mode enabled |
-| `sonnet35()`       | Anthropic   | claude-3-5-sonnet-20241022     | Anthropic's Claude 3.5 Sonnet model          |
-| `haiku35()`        | Anthropic   | claude-3-5-haiku-20241022      | Anthropic's Claude 3.5 Haiku model           |
-| `gemini25flash()`  | Google      | gemini-2.5-flash-preview-04-17 | Google's Gemini 2.5 Flash model              |
-| `gemini25proExp()` | Google      | gemini-2.5-pro-exp-03-25       | Google's Gemini 2.5 Pro Experimental model   |
-| `gemini25pro()`    | Google      | gemini-2.5-pro-preview-05-06   | Google's Gemini 2.5 Pro model                |
-| `sonar()`          | Perplexity  | sonar-pro                      | Perplexity's Sonar Pro model                 |
-| `qwen3()`          | Together AI | Qwen/Qwen3-235B-A22B-fp8-tput  | Together AI's Qwen 3 model                   |
-| `grok2()`          | Grok        | grok-2-latest                  | Grok's latest version 2 model                |
-| `grok3()`          | Grok        | grok-3-beta                    | Grok's version 3 beta model                  |
-| `grok3mini()`      | Grok        | grok-3-mini-beta               | Grok's version 3 mini beta model             |
-| `scout()`          | Cerebras    | llama-4-scout-17b-16e-instruct | Cerebras' Llama 4 Scout model                |
-
-Each method accepts optional `options` and `config` parameters to customize the model's behavior. For example:
-
-```javascript
-const result = await ModelMix.create()
-    .sonnet37({ 
-        options: { temperature: 0.7 },
-        config: { system: "You are a helpful assistant" }
-    })
-    .message();
-```
-
 **Methods**
 
-- `attach(modelInstance)`: Attaches a model instance to the `ModelMix`.
-- `create(modelKey, overOptions = {})`: Creates a new `MessageHandler` for the specified model.
-
-### MessageHandler Class Overview
-
-**Methods**
+- `attach(modelKey, modelInstance)`: Attaches a model instance to the `ModelMix`.
+- `new()`: `static` Creates a new `ModelMix`.
+- `new()`: Creates a new `ModelMix` using instance setup.
 
-- `new()`: Initializes a new message handler instance.
 - `addText(text, config = { role: "user" })`: Adds a text message.
 - `addTextFromFile(filePath, config = { role: "user" })`: Adds a text message from a file path.
 - `addImage(filePath, config = { role: "user" })`: Adds an image message from a file path.

package/demo/custom.mjs

@@ -1,6 +1,6 @@
 import 'dotenv/config'
 
-import { ModelMix, MixCerebras } from '../index.js';
+import { ModelMix, MixCustom } from '../index.js';
 
 const mmix = new ModelMix({
     options: {
@@ -13,8 +13,46 @@ const mmix = new ModelMix({
     }
 });
 
-mmix.attach(new MixCerebras());
+class MixTogether extends MixCustom {
+    getDefaultConfig(customConfig) {
+        return super.getDefaultConfig({
+            url: 'https://api.together.xyz/v1/chat/completions',
+            apiKey: process.env.TOGETHER_API_KEY,
+            ...customConfig
+        });
+    }
+
+    getDefaultOptions(customOptions) {
+        return {
+            stop: ["<|eot_id|>", "<|eom_id|>"],
+            ...customOptions
+        };
+    }
+
+    static convertMessages(messages) {
+        return messages.map(message => {
+            if (message.content instanceof Array) {
+                message.content = message.content.map(content => content.text).join("\n\n");
+            }
+            return message;
+        });
+    }
+
+    async create({ config = {}, options = {} } = {}) {
+        if (!this.config.apiKey) {
+            throw new Error('Together API key not found. Please provide it in config or set TOGETHER_API_KEY environment variable.');
+        }
+
+        const content = config.system + config.systemExtra;
+        options.messages = [{ role: 'system', content }, ...options.messages || []];
+        options.messages = MixTogether.convertMessages(options.messages);
+
+        return super.create({ config, options });
+    }
+}
+
+mmix.attach('Qwen/Qwen3-235B-A22B-fp8-tput', new MixTogether());
 
-let r = mmix.create('llama-4-scout-17b-16e-instruct').addText('hi there');
+let r = mmix.addText('hi there');
 r = await r.addText('do you like cats?').message();
 console.log(r);

package/demo/demo.mjs

@@ -5,6 +5,7 @@ import { ModelMix, MixOpenAI, MixAnthropic, MixPerplexity, MixOllama } from '../
 const mmix = new ModelMix({
     options: {
         max_tokens: 200,
+        temperature: 0.5,
     },
     config: {
         system: 'You are {name} from Melmac.',
@@ -14,52 +15,44 @@ const mmix = new ModelMix({
     }
 });
 
-mmix.attach(new MixOpenAI());
-mmix.attach(new MixAnthropic());
-mmix.attach(new MixPerplexity({
-    config: {
-        apiKey: process.env.PPLX_API_KEY,
-        system: 'You are my personal assistant.'
-    },
 
-}));
-mmix.attach(new MixOllama({
+const pplxSettings = {
     config: {
-        prefix: ['llava'],
-    },
-    options: {
-        temperature: 0.5,
+        apiKey: process.env.PPLX_API_KEY,
+        system: 'You are my personal assistant.',
+        max_tokens: 500
     }
-}));
+};
+
 
 mmix.replace({ '{name}': 'ALF' });
 
 console.log("\n" + '--------| gpt-4.1-nano |--------');
-const gpt = mmix.create('gpt-4.1-nano', { options: { temperature: 0 } }).addText("Have you ever eaten a {animal}?");
+const gpt = mmix.attach('gpt-4.1-nano', new MixOpenAI({ options: { temperature: 0 } })).addText("Have you ever eaten a {animal}?");
 gpt.replace({ '{animal}': 'cat' });
 console.log(await gpt.json({ time: '24:00:00', message: 'Hello' }, { time: 'Time in format HH:MM:SS' }));
 
-// console.log("\n" + '--------| claude-3-5-sonnet-20240620 |--------');
-// const claude = mmix.create('claude-3-5-sonnet-20240620', { options: { temperature: 0 } });
-// claude.addImageFromUrl('https://pbs.twimg.com/media/F6-GsjraAAADDGy?format=jpg');
-// const imageDescription = await claude.addText('describe the image').message();
-// console.log(imageDescription);
+console.log("\n" + '--------| claude-3-5-sonnet-20240620 |--------');
+const claude = ModelMix.new().attach('claude-3-5-sonnet-20240620', new MixAnthropic());
+claude.addImageFromUrl('https://pbs.twimg.com/media/F6-GsjraAAADDGy?format=jpg');
+const imageDescription = await claude.addText('describe the image').message();
+console.log(imageDescription);
 
 console.log("\n" + '--------| claude-3-7-sonnet-20250219 |--------');
-const writer = mmix.create('claude-3-7-sonnet-20250219', { options: { temperature: 0.5 } });
+const writer = ModelMix.new().attach('claude-3-7-sonnet-20250219', new MixAnthropic());
 writer.setSystem('You are a writer like Stephen King');
 writer.replaceKeyFromFile('{story_title}', './title.md');
 const story = await writer.addTextFromFile('./prompt.md').message();
 console.log(story);
 
-// console.log("\n" + '--------| llama-3-sonar-large-32k-online |--------');
-// const pplx = mmix.create('llama-3-sonar-large-32k-online', { config: { max_tokens: 500 } });
-// pplx.addText('How much is ETH trading in USD?');
-// const news = await pplx.addText('What are the 3 most recent Ethereum news?').message();
-// console.log(news);
+console.log("\n" + '--------| sonar |--------');
+const pplx = ModelMix.new().sonar(pplxSettings);
+pplx.addText('How much is ETH trading in USD?');
+const ETH = await pplx.json({ price: 1000.1 });
+console.log(ETH.price);
 
 // console.log("\n" + '--------| ollama (llava:latest) |--------');
-// await mmix.create('llava:latest')
+// await mmix.new().attach('llava:latest', new MixOllama())
 //     .addImage('./watson.jpg')
 //     .addText('what is the predominant color?')
 //     .stream((data) => { console.log(data.message); });

package/demo/fallback.mjs

@@ -15,24 +15,13 @@ const mmix = new ModelMix({
         max_tokens: 8192,
     }
 });
-const an = new MixAnthropic();
-an.config.url = 'fail';
-mmix.attach(new MixOpenAI(), an, new MixGrok());
 
-
-const modelOptionsRef = ['claude-3-5-sonnet-20241022', 'gpt-4.1-nano'];
+mmix.sonnet37({ config: { url: 'fail' } }).gpt41nano();
 
 async function main() {
-    const response = await generateThread(modelOptionsRef);
+    mmix.addText('hola, como estas?');
+    const response = await mmix.message();
     console.log(response);
 }
 
-async function generateThread(modelOptionsRef) {
-    const model = mmix.create(modelOptionsRef, { options: { temperature: 0.5 } });
-    model.addText('hola, como estas?');
-    const response = await model.message();
-
-    return response.split('---').map(section => section.trim());
-}
-
 main();

package/demo/grok.mjs

@@ -1,6 +1,6 @@
 import 'dotenv/config'
 
-import { ModelMix, MixGrok, MixAnthropic, MixOpenAI } from '../index.js';
+import { ModelMix } from '../index.js';
 
 const mmix = new ModelMix({
     options: {
@@ -8,11 +8,14 @@ const mmix = new ModelMix({
     },
     config: {
         system: 'You are ALF from Melmac.',
-        max_history: 2
+        max_history: 2,
+        debug: true
     }
 });
 
-mmix.attach(new MixGrok(), new MixAnthropic(), new MixOpenAI());
 
-const r = await mmix.create(['claude-3-7-sonnet-20250219', 'o3-mini', 'grok-2-latest']).addText('do you like cats?').message();
+const r = await mmix.grok2()
+    .addText('hi there!')
+    .addText('do you like cats?')
+    .message();
 console.log(r);

package/demo/groq.mjs

@@ -14,11 +14,11 @@ const mmix = new ModelMix({
     }
 });
 
-mmix.attach(new MixGroq({
+mmix.attach('deepseek-r1-distill-llama-70b', new MixGroq({
     config: {
         apiKey: env.GROQ_API_KEY,
     }
 }));
 
-const r = await mmix.create('deepseek-r1-distill-llama-70b').addText('do you like cats?').message();
+const r = await mmix.addText('do you like cats?').message();
 console.log(r)