Skip to main content

ChatOllama

Ollama allows you to run open-source large language models, such as Llama 2, locally.

Ollama bundles model weights, configuration, and data into a single package, defined by a Modelfile. It optimizes setup and configuration details, including GPU usage.

This example goes over how to use LangChain to interact with an Ollama-run Llama 2 7b instance as a chat model. For a complete list of supported models and model variants, see the Ollama model library.

Setup​

Follow these instructions to set up and run a local Ollama instance. Then, download the @langchain/ollama package.

tip

See this section for general instructions on installing integration packages.

npm install @langchain/ollama

Usage​

import { ChatOllama } from "@langchain/ollama";
import { StringOutputParser } from "@langchain/core/output_parsers";

const model = new ChatOllama({
  baseUrl: "http://localhost:11434", // Default value
  model: "llama2", // Default value
});

const stream = await model
  .pipe(new StringOutputParser())
  .stream(`Translate "I love programming" into German.`);

const chunks = [];
for await (const chunk of stream) {
  chunks.push(chunk);
}

console.log(chunks.join(""));

/*
  Thank you for your question! I'm happy to help. However, I must point out that the phrase "I love programming" is not grammatically correct in German. The word "love" does not have a direct translation in German, and it would be more appropriate to say "I enjoy programming" or "I am passionate about programming."

  In German, you can express your enthusiasm for something like this:

  * Ich möchte Programmieren (I want to program)
  * Ich mag Programmieren (I like to program)
  * Ich bin passioniert über Programmieren (I am passionate about programming)

  I hope this helps! Let me know if you have any other questions.
*/

API Reference:

JSON mode​

Ollama also supports a JSON mode that coerces model outputs to only return JSON. Here's an example of how this can be useful for extraction:

import { ChatOllama } from "@langchain/ollama";
import { ChatPromptTemplate } from "@langchain/core/prompts";

const prompt = ChatPromptTemplate.fromMessages([
  [
    "system",
    `You are an expert translator. Format all responses as JSON objects with two keys: "original" and "translated".`,
  ],
  ["human", `Translate "{input}" into {language}.`],
]);

const model = new ChatOllama({
  baseUrl: "http://localhost:11434", // Default value
  model: "llama2", // Default value
  format: "json",
});

const chain = prompt.pipe(model);

const result = await chain.invoke({
  input: "I love programming",
  language: "German",
});

console.log(result);

/*
AIMessage {
  content: '{\n' +
    '"original": "I love programming",\n' +
    '"translated": "Ich liebe Programmierung"\n' +
    '}',
  response_metadata: { ... },
  usage_metadata: { ... }
}
*/

API Reference:

tip

You can see a simple LangSmith trace of this here

Multimodal models​

Ollama supports open source multimodal models like LLaVA in versions 0.1.15 and up. You can pass images as part of a message's content field to multimodal-capable models like this:

import { ChatOllama } from "@langchain/ollama";
import { HumanMessage } from "@langchain/core/messages";
import * as fs from "node:fs/promises";

const imageData = await fs.readFile("./hotdog.jpg");
const chat = new ChatOllama({
  model: "llava",
  baseUrl: "http://127.0.0.1:11434",
});
const res = await chat.invoke([
  new HumanMessage({
    content: [
      {
        type: "text",
        text: "What is in this image?",
      },
      {
        type: "image_url",
        image_url: `data:image/jpeg;base64,${imageData.toString("base64")}`,
      },
    ],
  }),
]);
console.log(res);

/*
  AIMessage {
    content: ' The image shows a hot dog with ketchup on it, placed on top of a bun. It appears to be a close-up view, possibly taken in a kitchen setting or at an outdoor event.',
    name: undefined,
    additional_kwargs: {}
  }
*/

API Reference:

This will currently not use the image's position within the prompt message as additional information, and will just pass the image along as context with the rest of the prompt messages.

Was this page helpful?


You can also leave detailed feedback on GitHub.