El complemento Ollama proporciona interfaces para cualquiera de los LLM locales compatibles con Ollama:
Instalación
npm i --save genkitx-ollama
Configuración
Este complemento requiere que primero instales y ejecutes el servidor ollama. Puedes seguir Instrucciones: https://ollama.com/download
Puedes usar la CLI de Ollama para descargar el modelo que te interesa. Por ejemplo:
ollama pull gemma
Para usar este complemento, debes especificarlo cuando llames a configureGenkit()
.
import { ollama } from 'genkitx-ollama';
export default configureGenkit({
plugins: [
ollama({
models: [
{
name: 'gemma',
type: 'generate', // type: 'chat' | 'generate' | undefined
},
],
serverAddress: 'http://127.0.0.1:11434', // default local address
}),
],
});
Authentication
Si quieres acceder a implementaciones remotas de ollama que requieren encabezados personalizados (estáticos, como claves de API, o dinámicas, como encabezados de autenticación), puedes especificarlas en el complemento de configuración ollama:
Encabezados estáticos:
ollama({
models: [{ name: 'gemma'}],
requestHeaders: {
'api-key': 'API Key goes here'
},
serverAddress: 'https://my-deployment',
}),
También puedes establecer encabezados de manera dinámica por solicitud. Este es un ejemplo de cómo configurar un token de ID usando la biblioteca de Google Auth:
import { GoogleAuth } from 'google-auth-library';
import { ollama, OllamaPluginParams } from 'genkitx-ollama';
import { configureGenkit, isDevEnv } from '@genkit-ai/core';
const ollamaCommon = {models: [{name: "gemma:2b"}]};
const ollamaDev = {
...ollamaCommon,
serverAddress: 'http://127.0.0.1:11434',
} as OllamaPluginParams;
const ollamaProd = {
...ollamaCommon,
serverAddress: 'https://my-deployment',
requestHeaders: async (params) => ({
Authorization: `Bearer ${await getIdToken(params.serverAddress)}`,
}),
} as OllamaPluginParams;
export default configureGenkit({
plugins: [
ollama(isDevEnv() ? ollamaDev: ollamaProd),
],
});
export async function getIdToken(url: string): Promise<string> {
const auth = getAuthClient();
const client = await auth.getIdTokenClient(url);
return client.idTokenProvider.fetchIdToken(url);
}
let auth: GoogleAuth;
function getAuthClient() {
// Lazy load GoogleAuth client.
if (!auth) {
auth = new GoogleAuth();
}
return auth;
}
Uso
Este complemento no exporta de forma estática las referencias del modelo. Especifica uno de los que configuraste con un identificador de cadenas:
const llmResponse = await generate({
model: 'ollama/gemma',
prompt: 'Tell me a joke.',
});