Ollama

Get up and running with large language models.

macOS

Download

Windows

Download

Linux

curl -fsSL https://ollama.com/install.sh | sh

Manual install instructions

Docker

The official Ollama Docker image ollama/ollama is available on Docker Hub.

Libraries

• ollama-python
• ollama-js

Quickstart

To run and chat with Llama 3.2:

ollama run llama3.2

Model library

Ollama supports a list of models available on ollama.com/library

Here are some example models that can be downloaded:

Model	Parameters	Size	Download
Llama 3.2	3B	2.0GB	ollama run llama3.2
Llama 3.2	1B	1.3GB	ollama run llama3.2:1b
Llama 3.2 Vision	11B	7.9GB	ollama run llama3.2-vision
Llama 3.2 Vision	90B	55GB	ollama run llama3.2-vision:90b
Llama 3.1	8B	4.7GB	ollama run llama3.1
Llama 3.1	70B	40GB	ollama run llama3.1:70b
Llama 3.1	405B	231GB	ollama run llama3.1:405b
Phi 3 Mini	3.8B	2.3GB	ollama run phi3
Phi 3 Medium	14B	7.9GB	ollama run phi3:medium
Gemma 2	2B	1.6GB	ollama run gemma2:2b
Gemma 2	9B	5.5GB	ollama run gemma2
Gemma 2	27B	16GB	ollama run gemma2:27b
Mistral	7B	4.1GB	ollama run mistral
Moondream 2	1.4B	829MB	ollama run moondream
Neural Chat	7B	4.1GB	ollama run neural-chat
Starling	7B	4.1GB	ollama run starling-lm
Code Llama	7B	3.8GB	ollama run codellama
Llama 2 Uncensored	7B	3.8GB	ollama run llama2-uncensored
LLaVA	7B	4.5GB	ollama run llava
Solar	10.7B	6.1GB	ollama run solar

[!NOTE] You should have at least 8 GB of RAM available to run the 7B models, 16 GB to run the 13B models, and 32 GB to run the 33B models.

Customize a model

Import from GGUF

Ollama supports importing GGUF models in the Modelfile:

1. Create a file named Modelfile, with a FROM instruction with the local filepath to the model you want to import.

   FROM ./vicuna-33b.Q4_0.gguf
   

2. Create the model in Ollama

   ollama create example -f Modelfile
   

3. Run the model

   ollama run example
   

Import from PyTorch or Safetensors

See the guide on importing models for more information.

Customize a prompt

Models from the Ollama library can be customized with a prompt. For example, to customize the llama3.2 model:

ollama pull llama3.2

Create a Modelfile:

FROM llama3.2

# set the temperature to 1 [higher is more creative, lower is more coherent]
PARAMETER temperature 1

# set the system message
SYSTEM """
You are Mario from Super Mario Bros. Answer as Mario, the assistant, only.
"""

Next, create and run the model:

ollama create mario -f ./Modelfile
ollama run mario
>>> hi
Hello! It's your friend Mario.

For more examples, see the examples directory. For more information on working with a Modelfile, see the Modelfile documentation.

CLI Reference

Create a model

ollama create is used to create a model from a Modelfile.

ollama create mymodel -f ./Modelfile

Pull a model

ollama pull llama3.2

This command can also be used to update a local model. Only the diff will be pulled.

Remove a model

ollama rm llama3.2

Copy a model

ollama cp llama3.2 my-model

Multiline input

For multiline input, you can wrap text with """:

>>> """Hello,
... world!
... """
I'm a basic program that prints the famous "Hello, world!" message to the console.

Multimodal models

ollama run llava "What's in this image? /Users/jmorgan/Desktop/smile.png"
The image features a yellow smiley face, which is likely the central focus of the picture.

Pass the prompt as an argument

$ ollama run llama3.2 "Summarize this file: $(cat README.md)"
 Ollama is a lightweight, extensible framework for building and running language models on the local machine. It provides a simple API for creating, running, and managing models, as well as a library of pre-built models that can be easily used in a variety of applications.

Show model information

ollama show llama3.2

List models on your computer

ollama list

List which models are currently loaded

ollama ps

Stop a model which is currently running

ollama stop llama3.2

Start Ollama

ollama serve is used when you want to start ollama without running the desktop application.

Building

See the developer guide

Running local builds

Next, start the server:

./ollama serve

Finally, in a separate shell, run a model:

./ollama run llama3.2

REST API

Ollama has a REST API for running and managing models.

Generate a response

curl http://localhost:11434/api/generate -d '{
  "model": "llama3.2",
  "prompt":"Why is the sky blue?"
}'

Chat with a model

curl http://localhost:11434/api/chat -d '{
  "model": "llama3.2",
  "messages": [
    { "role": "user", "content": "why is the sky blue?" }
  ]
}'

See the API documentation for all endpoints.

Community Integrations

Web & Desktop

• Open WebUI
• Enchanted (macOS native)
• Hollama
• Lollms-Webui
• LibreChat
• Bionic GPT
• HTML UI
• Saddle
• Chatbot UI
• Chatbot UI v2
• Typescript UI
• Minimalistic React UI for Ollama Models
• Ollamac
• big-AGI
• Cheshire Cat assistant framework
• Amica
• chatd
• Ollama-SwiftUI
• Dify.AI
• MindMac
• NextJS Web Interface for Ollama
• Msty
• Chatbox
• WinForm Ollama Copilot
• NextChat with Get Started Doc
• Alpaca WebUI
• OllamaGUI
• OpenAOE
• Odin Runes
• LLM-X (Progressive Web App)
• AnythingLLM (Docker + MacOs/Windows/Linux native app)
• Ollama Basic Chat: Uses HyperDiv Reactive UI
• Ollama-chats RPG
• QA-Pilot (Interactive chat tool that can leverage Ollama models for rapid understanding and navigation of GitHub code repositories)
• ChatOllama (Open Source Chatbot based on Ollama with Knowledge Bases)
• CRAG Ollama Chat (Simple Web Search with Corrective RAG)
• RAGFlow (Open-source Retrieval-Augmented Generation engine based on deep document understanding)
• StreamDeploy (LLM Application Scaffold)
• chat (chat web app for teams)
• Lobe Chat with Integrating Doc
• Ollama RAG Chatbot (Local Chat with multiple PDFs using Ollama and RAG)
• BrainSoup (Flexible native client with RAG & multi-agent automation)
• macai (macOS client for Ollama, ChatGPT, and other compatible API back-ends)
• RWKV-Runner (RWKV offline LLM deployment tool, also usable as a client for ChatGPT and Ollama)
• Ollama Grid Search (app to evaluate and compare models)
• Olpaka (User-friendly Flutter Web App for Ollama)
• OllamaSpring (Ollama Client for macOS)
• LLocal.in (Easy to use Electron Desktop Client for Ollama)
• Shinkai Desktop (Two click install Local AI using Ollama + Files + RAG)
• AiLama (A Discord User App that allows you to interact with Ollama anywhere in discord )
• Ollama with Google Mesop (Mesop Chat Client implementation with Ollama)
• R2R (Open-source RAG engine)
• Ollama-Kis (A simple easy to use GUI with sample custom LLM for Drivers Education)
• OpenGPA (Open-source offline-first Enterprise Agentic Application)
• Painting Droid (Painting app with AI integrations)
• Kerlig AI (AI writing assistant for macOS)
• AI Studio
• Sidellama (browser-based LLM client)
• LLMStack (No-code multi-agent framework to build LLM agents and workflows)
• BoltAI for Mac (AI Chat Client for Mac)
• Harbor (Containerized LLM Toolkit with Ollama as default backend)
• PyGPT (AI desktop assistant for Linux, Windows and Mac)
• AutoGPT (AutoGPT Ollama integration)
• Go-CREW (Powerful Offline RAG in Golang)
• PartCAD (CAD model generation with OpenSCAD and CadQuery)
• Ollama4j Web UI - Java-based Web UI for Ollama built with Vaadin, Spring Boot and Ollama4j
• PyOllaMx - macOS application capable of chatting with both Ollama and Apple MLX models.
• Claude Dev - VSCode extension for multi-file/whole-repo coding
• Cherry Studio (Desktop client with Ollama support)
• ConfiChat (Lightweight, standalone, multi-platform, and privacy focused LLM chat interface with optional encryption)
• Archyve (RAG-enabling document library)
• crewAI with Mesop (Mesop Web Interface to run crewAI with Ollama)
• Tkinter-based client (Python tkinter-based Client for Ollama)
• LLMChat (Privacy focused, 100% local, intuitive all-in-one chat interface)
• Local Multimodal AI Chat (Ollama-based LLM Chat with support for multiple features, including PDF RAG, voice chat, image-based interactions, and integration with OpenAI.)
• ARGO (Locally download and run Ollama and Huggingface models with RAG on Mac/Windows/Linux)
• OrionChat - OrionChat is a web interface for chatting with different AI providers
• G1 (Prototype of using prompting strategies to improve the LLM's reasoning through o1-like reasoning chains.)
• Web management (Web management page)
• Promptery (desktop client for Ollama.)
• Ollama App (Modern and easy-to-use multi-platform client for Ollama)
• SpaceLlama (Firefox and Chrome extension to quickly summarize web pages with ollama in a sidebar)
• YouLama (Webapp to quickly summarize any YouTube video, supporting Invidious as well)
• DualMind (Experimental app allowing two models to talk to each other in the terminal or in a web interface)
• ollamarama-matrix (Ollama chatbot for the Matrix chat protocol)
• ollama-chat-app (Flutter-based chat app)
• Perfect Memory AI (Productivity AI assists personalized by what you have seen on your screen, heard and said in the meetings)
• Hexabot (A conversational AI builder)
• Reddit Rate (Search and Rate Reddit topics with a weighted summation)
• OpenTalkGpt (Chrome Extension to manage open-source models supported by Ollama, create custom models, and chat with models from a user-friendly UI)
• VT (A minimal multimodal AI chat app, with dynamic conversation routing. Supports local models via Ollama)
• Nosia (Easy to install and use RAG platform based on Ollama)
• Witsy (An AI Desktop application avaiable for Mac/Windows/Linux)
• Abbey (A configurable AI interface server with notebooks, document storage, and YouTube support)
• Minima (RAG with on-premises or fully local workflow)

Cloud

• Google Cloud
• Fly.io
• Koyeb

Terminal

• oterm
• Ellama Emacs client
• Emacs client
• gen.nvim
• ollama.nvim
• ollero.nvim
• ollama-chat.nvim
• ogpt.nvim
• gptel Emacs client
• Oatmeal
• cmdh
• ooo
• shell-pilot(Interact with models via pure shell scripts on Linux or macOS)
• tenere
• llm-ollama for Datasette's LLM CLI.
• typechat-cli
• ShellOracle
• tlm
• podman-ollama
• gollama
• ParLlama
• Ollama eBook Summary
• Ollama Mixture of Experts (MOE) in 50 lines of code
• vim-intelligence-bridge Simple interaction of "Ollama" with the Vim editor
• x-cmd ollama
• bb7
• SwollamaCLI bundled with the Swollama Swift package. Demo
• aichat All-in-one LLM CLI tool featuring Shell Assistant, Chat-REPL, RAG, AI tools & agents, with access to OpenAI, Claude, Gemini, Ollama, Groq, and more.
• PowershAI PowerShell module that brings AI to terminal on Windows, including support for Ollama
• orbiton Configuration-free text editor and IDE with support for tab completion with Ollama.

Apple Vision Pro

• Enchanted

Database

• MindsDB (Connects Ollama models with nearly 200 data platforms and apps)
• chromem-go with example

Package managers

• Pacman
• Gentoo
• Helm Chart
• Guix channel
• Nix package
• Flox

Libraries

• LangChain and LangChain.js with example
• Firebase Genkit
• crewAI
• Spring AI with reference and example
• LangChainGo with example
• LangChain4j with example
• LangChainRust with example
• LLPhant
• LlamaIndex and LlamaIndexTS
• LiteLLM
• OllamaFarm for Go
• OllamaSharp for .NET
• Ollama for Ruby
• Ollama-rs for Rust
• Ollama-hpp for C++
• Ollama4j for Java
• ModelFusion Typescript Library
• OllamaKit for Swift
• Ollama for Dart
• Ollama for Laravel
• LangChainDart
• Semantic Kernel - Python
• Haystack
• Elixir LangChain
• Ollama for R - rollama
• Ollama for R - ollama-r
• Ollama-ex for Elixir
• Ollama Connector for SAP ABAP
• Testcontainers
• Portkey
• PromptingTools.jl with an example
• LlamaScript
• llm-axe (Python Toolkit for Building LLM Powered Apps)
• Gollm
• Gollama for Golang
• Ollamaclient for Golang
• High-level function abstraction in Go
• Ollama PHP
• Agents-Flex for Java with example
• Parakeet is a GoLang library, made to simplify the development of small generative AI applications with Ollama.
• Haverscript with examples
• Ollama for Swift
• Swollama for Swift with DocC
• GoLamify
• Ollama for Haskell
• multi-llm-ts (A Typescript/JavaScript library allowing access to different LLM in unified API)

Mobile

• Enchanted
• Maid
• Ollama App (Modern and easy-to-use multi-platform client for Ollama)
• ConfiChat (Lightweight, standalone, multi-platform, and privacy focused LLM chat interface with optional encryption)

Extensions & Plugins

• Raycast extension
• Discollama (Discord bot inside the Ollama discord channel)
• Continue
• Vibe (Transcribe and analyze meetings with Ollama)
• Obsidian Ollama plugin
• Logseq Ollama plugin
• NotesOllama (Apple Notes Ollama plugin)
• Dagger Chatbot
• Discord AI Bot
• Ollama Telegram Bot
• Hass Ollama Conversation
• Rivet plugin
• Obsidian BMO Chatbot plugin
• Cliobot (Telegram bot with Ollama support)
• Copilot for Obsidian plugin
• Obsidian Local GPT plugin
• Open Interpreter
• Llama Coder (Copilot alternative using Ollama)
• Ollama Copilot (Proxy that allows you to use ollama as a copilot like Github copilot)
• twinny (Copilot and Copilot chat alternative using Ollama)
• Wingman-AI (Copilot code and chat alternative using Ollama and Hugging Face)
• Page Assist (Chrome Extension)
• Plasmoid Ollama Control (KDE Plasma extension that allows you to quickly manage/control Ollama model)
• AI Telegram Bot (Telegram bot using Ollama in backend)
• AI ST Completion (Sublime Text 4 AI assistant plugin with Ollama support)
• Discord-Ollama Chat Bot (Generalized TypeScript Discord Bot w/ Tuning Documentation)
• ChatGPTBox: All in one browser extension with Integrating Tutorial
• Discord AI chat/moderation bot Chat/moderation bot written in python. Uses Ollama to create personalities.
• Headless Ollama (Scripts to automatically install ollama client & models on any OS for apps that depends on ollama server)
• Terraform AWS Ollama & Open WebUI (A Terraform module to deploy on AWS a ready-to-use Ollama service, together with its front end Open WebUI service.)
• node-red-contrib-ollama
• Local AI Helper (Chrome and Firefox extensions that enable interactions with the active tab and customisable API endpoints. Includes secure storage for user prompts.)
• vnc-lm (Discord bot for messaging with LLMs through Ollama and LiteLLM. Seamlessly move between local and flagship models.)
• LSP-AI (Open-source language server for AI-powered functionality)
• QodeAssist (AI-powered coding assistant plugin for Qt Creator)
• Obsidian Quiz Generator plugin
• TextCraft (Copilot in Word alternative using Ollama)
• Alfred Ollama (Alfred Workflow)

Supported backends

• llama.cpp project founded by Georgi Gerganov.

Observability

• OpenLIT is an OpenTelemetry-native tool for monitoring Ollama Applications & GPUs using traces and metrics.
• HoneyHive is an AI observability and evaluation platform for AI agents. Use HoneyHive to evaluate agent performance, interrogate failures, and monitor quality in production.