Biblioteca cliente oficial de Python para usar los modelos locales y en la nube de Ollama mediante APIs de chat, generación, embeddings y gestión de modelos.
ollama/ollama-js
La biblioteca oficial de cliente JavaScript/TypeScript para Ollama, para conversar con LLM locales o en la nube y gestionarlos desde Node.js y navegadores.
- Estrellas
- 4,397
- Forks
- 482
- Issues abiertos
- 99
- Último commit
- hace 6 días
¿Qué es?
ollama-js es el cliente oficial de JavaScript para Ollama, un entorno de ejecución de modelos de lenguaje grandes. Envuelve la REST API de Ollama en una interfaz basada en promesas, para que las aplicaciones de Node.js y de navegador puedan enviar solicitudes de chat y generación, descargar o subir modelos, crear modelos personalizados y enumerar o inspeccionar los modelos instalados.
La biblioteca se instala desde npm como `ollama` y ofrece un punto de entrada independiente, `ollama/browser`, para usarla fuera de Node. Las respuestas se pueden transmitir mediante un generador asíncrono, y un cliente personalizado permite configurar el host, la implementación de fetch y los encabezados. La biblioteca también incluye embeddings, llamadas a herramientas, entradas de imagen y un método para cancelar flujos activos.
También admite modelos en la nube: al iniciar sesión en una instancia local de Ollama o al apuntar el cliente a ollama.com con una API key, se pueden usar los mismos métodos para ejecutar modelos alojados de mayor tamaño. También incluye funciones auxiliares de búsqueda y obtención de contenido web, además de una API de decisión System One.
Funciones clave
- 01Solicitudes de chat y generación, con transmisión opcional mediante generadores asíncronos.
- 02Métodos de gestión de modelos: descargar, subir, crear, copiar, eliminar, enumerar y mostrar.
- 03Generación de embeddings y compatibilidad con llamadas a herramientas.
- 04Punto de entrada independiente para navegador en `ollama/browser`.
- 05Opciones de cliente personalizadas para el host, fetch y los encabezados de las solicitudes.
- 06Acceso a modelos en la nube a través de ollama.com con una API key.
Casos de uso
- Añadir una función de chat con un LLM local a un backend o script de Node.js.
- Crear una interfaz de chat para navegador que se comunique con un servidor local de Ollama.
- Generar embeddings para flujos de búsqueda o recuperación desde código JavaScript.
- Usar modelos alojados de mayor tamaño con el mismo código que se emplea para los modelos locales.
Inicio rápido
- 1
Instala la biblioteca con npm
npm i ollama - 2
Importa el cliente y llama a chat con un modelo
Antes de usarlo
- Se necesita un servidor Ollama en ejecución o una clave de API de una cuenta de Ollama para usar modelos en la nube.
- Las funciones en la nube, como la búsqueda web y los modelos en la nube, requieren una cuenta de Ollama.
Temas
Preguntas frecuentes
- ¿Qué es ollama-js?
- La biblioteca oficial de cliente JavaScript/TypeScript para Ollama, para conversar con LLM locales o en la nube y gestionarlos desde Node.js y navegadores. ollama-js es el cliente oficial de JavaScript para Ollama, un entorno de ejecución de modelos de lenguaje grandes. Envuelve la REST API de Ollama en una interfaz basada en promesas, para que las aplicaciones de Node.js y de navegador puedan enviar solicitudes de chat y generación, descargar o subir modelos, crear modelos personalizados y enumerar o inspeccionar los modelos instalados.
- ¿ollama-js es gratuito? ¿Qué licencia tiene?
- ollama-js es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿ollama-js sigue mantenido?
- Mantenimiento activo. El último commit de ollama-js fue el 16 oct 2026.
- ¿Para qué puedo usar ollama-js?
- Añadir una función de chat con un LLM local a un backend o script de Node.js. Crear una interfaz de chat para navegador que se comunique con un servidor local de Ollama. Generar embeddings para flujos de búsqueda o recuperación desde código JavaScript. Usar modelos alojados de mayor tamaño con el mismo código que se emplea para los modelos locales.
- ¿Cómo se instala ollama-js?
- Instala la biblioteca con npm: npm i ollama Importa el cliente y llama a chat con un modelo
- ¿Dónde consigo ollama-js?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/ollama/ollama-js
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Herramienta de línea de comandos y biblioteca de Python para ejecutar prompts y chats con modelos de lenguaje grandes, remotos o instalados localmente.
Framework de TypeScript para crear aplicaciones y agentes con LLM, con interfaces estándar para modelos, herramientas, embeddings y almacenes vectoriales.
Editor de texto enriquecido sin interfaz y agnóstico al framework, basado en ProseMirror y ampliable con un amplio conjunto de extensiones.
Node.js es un entorno de ejecución de JavaScript de código abierto y multiplataforma para ejecutar JavaScript fuera del navegador.
SDK oficial de TypeScript para llamar a la API de Claude de Anthropic desde aplicaciones JavaScript y TypeScript del lado del servidor.