No description
Find a file
Matt Williams 9b513bb6b1
Merge pull request #753 from jmorganca/mattw/examplereorg
rename the examples to be more descriptive
2023-10-12 11:24:12 -07:00
api validate api options fields from map (#711) 2023-10-12 11:18:11 -04:00
app do not download updates multiple times (#633) 2023-09-28 15:29:17 -04:00
cmd relay model runner error message to client (#720) 2023-10-12 11:16:37 -04:00
docs optional parameter to not stream response (#639) 2023-10-11 12:54:27 -04:00
examples final rename 2023-10-12 11:23:41 -07:00
format add format bytes 2023-10-11 14:08:23 -07:00
llm relay model runner error message to client (#720) 2023-10-12 11:16:37 -04:00
parser Merge pull request #290 from jmorganca/add-adapter-layers 2023-08-10 17:23:01 -07:00
progressbar vendor in progress bar and change to bytes instead of bibytes (#130) 2023-07-19 17:24:03 -07:00
scripts fix build_docker.sh permissions 2023-10-01 16:42:32 -07:00
server validate api options fields from map (#711) 2023-10-12 11:18:11 -04:00
vector embed text document in modelfile 2023-08-08 11:27:17 -04:00
version add version 2023-08-22 09:40:58 -07:00
.dockerignore add .env to .dockerignore 2023-09-23 00:53:48 -04:00
.gitignore update docs for subprocess 2023-08-30 17:54:02 -04:00
.gitmodules silence warm up log 2023-09-21 14:53:33 -07:00
.prettierrc.json move .prettierrc.json to root 2023-07-02 17:34:46 -04:00
Dockerfile update Dockerfile to pass GOFLAGS 2023-10-03 07:05:15 -07:00
Dockerfile.build update Dockerfile to pass GOFLAGS 2023-10-03 07:05:15 -07:00
go.mod parallel chunked downloads 2023-10-06 12:56:43 -07:00
go.sum parallel chunked downloads 2023-10-06 12:56:43 -07:00
LICENSE proto -> ollama 2023-06-26 15:57:13 -04:00
main.go set non-zero error code on error 2023-08-14 14:09:58 -07:00
README.md fix relative links in README.md 2023-10-11 19:24:06 -04:00

logo

Ollama

Discord

Get up and running with large language models locally.

macOS

Download

Linux & WSL2

curl https://ollama.ai/install.sh | sh

Manual install instructions

Windows

coming soon

Quickstart

To run and chat with Llama 2:

ollama run llama2

Model library

Ollama supports a list of open-source models available on ollama.ai/library

Here are some example open-source models that can be downloaded:

Model Parameters Size Download
Mistral 7B 4.1GB ollama run mistral
Llama 2 7B 3.8GB ollama run llama2
Code Llama 7B 3.8GB ollama run codellama
Llama 2 Uncensored 7B 3.8GB ollama run llama2-uncensored
Llama 2 13B 13B 7.3GB ollama run llama2:13b
Llama 2 70B 70B 39GB ollama run llama2:70b
Orca Mini 3B 1.9GB ollama run orca-mini
Vicuna 7B 3.8GB ollama run vicuna

Note: You should have at least 8 GB of RAM to run the 3B models, 16 GB to run the 7B models, and 32 GB to run the 13B models.

Customize your own model

Import from GGUF or GGML

Ollama supports importing GGUF and GGML file formats in the Modelfile. This means if you have a model that is not in the Ollama library, you can create it, iterate on it, and upload it to the Ollama library to share with others when you are ready.

  1. Create a file named Modelfile, and add 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 name -f path_to_modelfile
    
  3. Run the model

    ollama run name
    

Customize a prompt

Models from the Ollama library can be customized with a prompt. The example

ollama pull llama2

Create a Modelfile:

FROM llama2

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

# set the system prompt
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.

Pull a model

ollama pull llama2

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

Remove a model

ollama rm llama2

Copy a model

ollama cp llama2 my-llama2

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.

Pass in prompt as arguments

$ ollama run llama2 "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.

List models on your computer

ollama list

Start Ollama

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

Building

Install cmake and go:

brew install cmake
brew install go

Then generate dependencies and build:

go generate ./...
go build .

Next, start the server:

./ollama serve

Finally, in a separate shell, run a model:

./ollama run llama2

REST API

See the API documentation for all endpoints.

Ollama has an API for running and managing models. For example to generate text from a model:

curl -X POST http://localhost:11434/api/generate -d '{
  "model": "llama2",
  "prompt":"Why is the sky blue?"
}'

Community Integrations