README.md 1.35 KB
Newer Older
Bruce MacDonald's avatar
Bruce MacDonald committed
1
# Ollama
Jeffrey Morgan's avatar
Jeffrey Morgan committed
2

Jeffrey Morgan's avatar
Jeffrey Morgan committed
3
The easiest way to run ai models.
Jeffrey Morgan's avatar
Jeffrey Morgan committed
4
5
6
7
8
9
10
11
12

## Download

- [macOS](https://ollama.ai/download/darwin) (Apple Silicon)
- macOS (Intel – Coming soon)
- Windows (Coming soon)
- Linux (Coming soon)

## Python SDK
Jeffrey Morgan's avatar
Jeffrey Morgan committed
13
14

```
Bruce MacDonald's avatar
Bruce MacDonald committed
15
pip install ollama
Jeffrey Morgan's avatar
Jeffrey Morgan committed
16
17
```

Jeffrey Morgan's avatar
Jeffrey Morgan committed
18
### Python SDK quickstart
Jeffrey Morgan's avatar
Jeffrey Morgan committed
19

Bruce MacDonald's avatar
Bruce MacDonald committed
20
21
```python
import ollama
Jeffrey Morgan's avatar
Jeffrey Morgan committed
22
ollama.generate("./llama-7b-ggml.bin", "hi")
Jeffrey Morgan's avatar
Jeffrey Morgan committed
23
24
```

Jeffrey Morgan's avatar
Jeffrey Morgan committed
25
### `ollama.generate(model, message)`
Bruce MacDonald's avatar
Bruce MacDonald committed
26

Jeffrey Morgan's avatar
Jeffrey Morgan committed
27
Generate a completion
Bruce MacDonald's avatar
Bruce MacDonald committed
28
29

```python
Jeffrey Morgan's avatar
Jeffrey Morgan committed
30
ollama.generate("./llama-7b-ggml.bin", "hi")
Jeffrey Morgan's avatar
Jeffrey Morgan committed
31
32
```

Jeffrey Morgan's avatar
Jeffrey Morgan committed
33
### `ollama.load(model)`
Jeffrey Morgan's avatar
Jeffrey Morgan committed
34

Jeffrey Morgan's avatar
Jeffrey Morgan committed
35
Load a model for generation
Jeffrey Morgan's avatar
Jeffrey Morgan committed
36

Bruce MacDonald's avatar
Bruce MacDonald committed
37
```python
Jeffrey Morgan's avatar
Jeffrey Morgan committed
38
ollama.load("model")
Jeffrey Morgan's avatar
Jeffrey Morgan committed
39
40
```

Jeffrey Morgan's avatar
Jeffrey Morgan committed
41
### `ollama.models()`
Jeffrey Morgan's avatar
Jeffrey Morgan committed
42

Jeffrey Morgan's avatar
Jeffrey Morgan committed
43
List available local models
Bruce MacDonald's avatar
Bruce MacDonald committed
44
45
46

```
models = ollama.models()
Jeffrey Morgan's avatar
Jeffrey Morgan committed
47
48
```

Jeffrey Morgan's avatar
Jeffrey Morgan committed
49
### `ollama.serve()`
Jeffrey Morgan's avatar
Jeffrey Morgan committed
50

Bruce MacDonald's avatar
Bruce MacDonald committed
51
Serve the ollama http server
Jeffrey Morgan's avatar
Jeffrey Morgan committed
52

Jeffrey Morgan's avatar
Jeffrey Morgan committed
53
## Cooming Soon
Jeffrey Morgan's avatar
Jeffrey Morgan committed
54

Jeffrey Morgan's avatar
Jeffrey Morgan committed
55
### `ollama.pull(model)`
Bruce MacDonald's avatar
Bruce MacDonald committed
56

Jeffrey Morgan's avatar
Jeffrey Morgan committed
57
Download a model
Bruce MacDonald's avatar
Bruce MacDonald committed
58
59
60

```python
ollama.pull("huggingface.co/thebloke/llama-7b-ggml")
Jeffrey Morgan's avatar
Jeffrey Morgan committed
61
62
```

Jeffrey Morgan's avatar
Jeffrey Morgan committed
63
### `ollama.import(filename)`
Bruce MacDonald's avatar
Bruce MacDonald committed
64

Jeffrey Morgan's avatar
Jeffrey Morgan committed
65
Import a model from a file
Bruce MacDonald's avatar
Bruce MacDonald committed
66
67
68
69

```python
ollama.import("./path/to/model")
```
Jeffrey Morgan's avatar
Jeffrey Morgan committed
70

Jeffrey Morgan's avatar
Jeffrey Morgan committed
71
### `ollama.search("query")`
72

Bruce MacDonald's avatar
Bruce MacDonald committed
73
Search for compatible models that Ollama can run
74

Bruce MacDonald's avatar
Bruce MacDonald committed
75
76
77
```python
ollama.search("llama-7b")
```
Jeffrey Morgan's avatar
Jeffrey Morgan committed
78

Bruce MacDonald's avatar
Bruce MacDonald committed
79
## Future CLI
80

Jeffrey Morgan's avatar
Jeffrey Morgan committed
81
In the future, there will be an `ollama` CLI for running models on servers, in containers or for local development environments.
Jeffrey Morgan's avatar
Jeffrey Morgan committed
82

Bruce MacDonald's avatar
Bruce MacDonald committed
83
```
Jeffrey Morgan's avatar
Jeffrey Morgan committed
84
ollama generate huggingface.co/thebloke/llama-7b-ggml "hi"
Jeffrey Morgan's avatar
Jeffrey Morgan committed
85
> Downloading [================>          ] 66.67% (2/3) 30.2MB/s
Bruce MacDonald's avatar
Bruce MacDonald committed
86
```
Bruce MacDonald's avatar
Bruce MacDonald committed
87
88
89
90

## Documentation

- [Development](docs/development.md)