2024-05-04 13:39:44 +00:00
|
|
|
## Usage
|
|
|
|
|
2024-05-11 09:32:02 +00:00
|
|
|
⚠️ This app runs on port **11434**. Take this into account when configuring tools connecting to the app.
|
|
|
|
|
2024-05-04 13:39:44 +00:00
|
|
|
### Use with a frontend
|
2024-05-11 09:32:02 +00:00
|
|
|
|
2024-05-04 13:39:44 +00:00
|
|
|
- [LobeChat](https://github.com/lobehub/lobe-chat)
|
|
|
|
- [LibreChat](https://github.com/danny-avila/LibreChat)
|
|
|
|
- [OpenWebUI](https://github.com/open-webui/open-webui)
|
|
|
|
- [And more ...](https://github.com/ollama/ollama)
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
### Try the REST API
|
2024-05-11 09:32:02 +00:00
|
|
|
|
2024-05-04 13:39:44 +00:00
|
|
|
Ollama has a REST API for running and managing models.
|
|
|
|
|
|
|
|
**Generate a response**
|
2024-05-11 09:32:02 +00:00
|
|
|
|
2024-05-04 13:39:44 +00:00
|
|
|
```sh
|
|
|
|
curl http://localhost:11434/api/generate -d '{
|
|
|
|
"model": "llama3",
|
|
|
|
"prompt":"Why is the sky blue?"
|
|
|
|
}'
|
|
|
|
```
|
|
|
|
|
|
|
|
**Chat with a model**
|
2024-05-11 09:32:02 +00:00
|
|
|
|
2024-05-04 13:39:44 +00:00
|
|
|
```sh
|
|
|
|
curl http://localhost:11434/api/chat -d '{
|
|
|
|
"model": "llama3",
|
|
|
|
"messages": [
|
|
|
|
{ "role": "user", "content": "why is the sky blue?" }
|
|
|
|
]
|
|
|
|
}'
|
|
|
|
```
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
## Compatible GPUs
|
2024-05-11 09:32:02 +00:00
|
|
|
|
2024-05-04 13:39:44 +00:00
|
|
|
Ollama supports the following AMD GPUs:
|
2024-05-11 09:32:02 +00:00
|
|
|
| Family | Cards and accelerators |
|
2024-05-04 13:39:44 +00:00
|
|
|
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
|
2024-05-11 09:32:02 +00:00
|
|
|
| AMD Radeon RX | `7900 XTX` `7900 XT` `7900 GRE` `7800 XT` `7700 XT` `7600 XT` `7600` `6950 XT` `6900 XTX` `6900XT` `6800 XT` `6800` `Vega 64` `Vega 56` |
|
2024-05-04 13:39:44 +00:00
|
|
|
| AMD Radeon PRO | `W7900` `W7800` `W7700` `W7600` `W7500` `W6900X` `W6800X Duo` `W6800X` `W6800` `V620` `V420` `V340` `V320` `Vega II Duo` `Vega II` `VII` `SSG` |
|
2024-05-11 09:32:02 +00:00
|
|
|
| AMD Instinct | `MI300X` `MI300A` `MI300` `MI250X` `MI250` `MI210` `MI200` `MI100` `MI60` `MI50` |
|
2024-05-04 13:39:44 +00:00
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
## Model library
|
2024-05-11 09:32:02 +00:00
|
|
|
|
2024-05-04 13:39:44 +00:00
|
|
|
Ollama supports a list of models available on [ollama.com/library](https://ollama.com/library 'ollama model library')
|
|
|
|
|
|
|
|
Here are some example models that can be downloaded:
|
|
|
|
|
|
|
|
| Model | Parameters | Size | Download |
|
|
|
|
| ------------------ | ---------- | ----- | ------------------------------ |
|
|
|
|
| Llama 3 | 8B | 4.7GB | `ollama run llama3` |
|
|
|
|
| Llama 3 | 70B | 40GB | `ollama run llama3:70b` |
|
|
|
|
| Phi-3 | 3,8B | 2.3GB | `ollama run phi3` |
|
|
|
|
| Mistral | 7B | 4.1GB | `ollama run mistral` |
|
|
|
|
| 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` |
|
|
|
|
| Gemma | 2B | 1.4GB | `ollama run gemma:2b` |
|
|
|
|
| Gemma | 7B | 4.8GB | `ollama run gemma:7b` |
|
|
|
|
| Solar | 10.7B | 6.1GB | `ollama run solar` |
|
|
|
|
|
2024-05-11 09:32:02 +00:00
|
|
|
> 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.
|