The Free Encyclopedia

Ollama AI Cheat Sheet

Revision as of Jun 25, 2026 22:26 by migration. This is an old revision — view current.

Master Ollama with this comprehensive cheat sheet covering installation, model management, API usage, and advanced configurations for running AI models locally.

Installation

Linux

curl -fsSL https://ollama.ai/install.sh | sh
# Manual installation:
curl -L https://ollama.ai/download/ollama-linux-amd64 -o /usr/local/bin/ollama
chmod +x /usr/local/bin/ollama

Windows

# Download installer from https://ollama.ai/download
# Or use Windows Package Manager:
winget install Ollama.Ollama

Docker

docker run -d -v ollama:/root/.ollama -p 11434:11434 --name ollama ollama/ollama
# With GPU support (NVIDIA):
docker run -d --gpus=all -v ollama:/root/.ollama -p 11434:11434 --name ollama ollama/ollama
TIP After installation, the Ollama service starts automatically. You can verify it's running by opening http://localhost:11434 in your browser.

Basic Commands

CommandDescriptionSyntax
Run a ModelStart an interactive session with a modelollama run [model_name]
List ModelsShow all installed modelsollama list
Pull ModelDownload a model from the registryollama pull [model_name]
Remove ModelDelete a model from local storageollama rm [model_name]
Show Model InfoDisplay model details and metadataollama show [model_name]
Copy ModelCreate a copy of a modelollama cp [source] [destination]

Common Usage Examples

# Start interactive chat with Llama 2
ollama run llama2

# Single prompt (AI responds once)
ollama run llama2 "Say hello"
ollama run llama2 "Explain quantum computing in simple terms"
ollama run llama2 "Write a Python function to sort a list"

# Pull the latest Codellama model
ollama pull codellama

# List all available models
ollama list
NAME           ID              SIZE    MODIFIED
llama2:latest  e38ae474bf77    3.8 GB  2 hours ago
codellama:7b   8fdf8f752f6e    3.8 GB  3 hours ago

# Get model information
ollama show llama2

# Remove a model
ollama rm llama2:13b

Available Models

ModelDescription
Llama 2 (7B, 13B, 70B)Meta's flagship language model
Llama 3 (8B, 70B)Latest Meta model with improved performance
Code Llama (7B, 13B, 34B)Specialized for code generation
Mistral (7B)High-performance 7B model
Mixtral (8x7B, 8x22B)Mixture of experts model
DeepSeek Coder (1.3B, 6.7B, 33B)Advanced coding model with fill-in-the-middle
DeepSeek LLM (7B, 67B)General purpose reasoning model
WizardLM (7B, 13B)Instruction-following model
WizardCoder (15B, 34B)Advanced code generation
WizardMath (7B, 13B, 70B)Mathematical reasoning specialist
OpenHermes 2.5 (7B)High-quality synthetic training data
Neural Chat (7B)Fine-tuned for conversations
Starling (7B)RLHF fine-tuned model
Orca Mini (3B, 7B, 13B)Compact reasoning model
Vicuna (7B, 13B, 33B)ChatGPT-style conversations
Zephyr (7B)Helpful assistant model
Dolphin (2.7, 7B, 13B, 70B)Uncensored fine-tune
Nous Hermes 2 (7B, 13B, 70B)Versatile assistant model
Yi (6B, 34B)Bilingual Chinese-English model
Qwen (7B, 14B, 72B)Alibaba's multilingual model
Phi-2 (2.7B)Microsoft's compact reasoning model
GPT-OSS (20B, 120B)Open-source GPT-style models

Model Tags and Versions

Base Language Models

# Llama family
ollama pull llama2:7b
ollama pull llama2:13b
ollama pull llama2:70b
ollama pull llama3:8b
ollama pull llama3:70b

# Mistral family
ollama pull mistral:latest
ollama pull mixtral:8x7b

# GPT-OSS models
ollama pull gpt-oss:20b
ollama pull gpt-oss:120b

Code-Specialized Models

# Code Llama variants
ollama pull codellama:7b-code
ollama pull codellama:7b-instruct
ollama pull codellama:7b-python

# DeepSeek Coder
ollama pull deepseek-coder:6.7b
ollama pull deepseek-coder:33b

# Wizard Coder
ollama pull wizardcoder:15b

Specialized Task Models

# Instruction following
ollama pull wizardlm:7b
ollama pull wizardlm:13b

# Mathematical reasoning
ollama pull wizardmath:7b

# General reasoning
ollama pull deepseek-llm:7b
ollama pull deepseek-llm:67b

Community & Fine-tuned Models

# Conversational models
ollama pull openhermes:7b
ollama pull nous-hermes2:7b

# Multilingual models
ollama pull qwen:7b
ollama pull yi:34b

# Compact models
ollama pull phi:2.7b
WARNING Storage Requirements: Models can be large! 7B models ~4GB, 13B models ~7GB, 70B models ~40GB. Ensure you have sufficient disk space.

API Usage

Generate Completion

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

Chat Completion

curl http://localhost:11434/api/chat -d '{
  "model": "llama2",
  "messages": [
    {
      "role": "user",
      "content": "Hello, how are you?"
    }
  ]
}'

Python Client

pip install ollama

# Python usage
import ollama

response = ollama.chat(model='llama2', messages=[
  {
    'role': 'user',
    'content': 'Why is the sky blue?',
  },
])
print(response['message']['content'])

JavaScript/Node.js

npm install ollama

// JavaScript usage
import ollama from 'ollama'

const response = await ollama.chat({
  model: 'llama2',
  messages: [{ role: 'user', content: 'Why is the sky blue?' }],
})
console.log(response.message.content)

Streaming Responses

curl http://localhost:11434/api/generate -d '{
  "model": "llama2",
  "prompt": "Tell me a story",
  "stream": true
}'

# Python streaming
for chunk in ollama.chat(
    model='llama2',
    messages=[{'role': 'user', 'content': 'Tell me a story'}],
    stream=True,
):
    print(chunk['message']['content'], end='', flush=True)

API Endpoints

EndpointMethodDescription
/api/generatePOSTGenerate text completion
/api/chatPOSTChat with conversational models
/api/tagsGETList available models
/api/showPOSTShow model information
/api/pullPOSTDownload a model
/api/pushPOSTUpload a model
/api/deleteDELETERemove a model

Text-to-Speech Integration

Using espeak (Linux)

# Install espeak
sudo apt install espeak

# Pipe Ollama output to speech
ollama run llama2 "Tell me a joke" | espeak

# With custom voice settings
ollama run llama2 "Hello world" | espeak -s 150 -v en+f3

Using Festival (Linux)

# Install Festival

Advanced Configuration

Environment Variables

# Set custom data directory
export OLLAMA_MODELS=/path/to/models

# Change default host and port
export OLLAMA_HOST=0.0.0.0:11434

# Enable debug logging
export OLLAMA_DEBUG=1

# Set maximum number of parallel requests
export OLLAMA_MAX_LOADED_MODELS=3

# GPU configuration
export OLLAMA_NUM_PARALLEL=4
export CUDA_VISIBLE_DEVICES=0,1

Model Configuration

# Create custom model with Modelfile
cat > Modelfile << EOF
FROM llama2
PARAMETER temperature 0.8
PARAMETER num_predict 100
SYSTEM "You are a helpful AI assistant."
EOF

# Build custom model
ollama create mymodel -f Modelfile

Performance Tuning

ParameterDescriptionDefault
num_predictMaximum tokens to generate128
temperatureRandomness (0.0-2.0)0.8
top_kTop-K sampling40
top_pTop-P sampling0.9
repeat_penaltyRepetition penalty1.1
num_ctxContext window size2048

Service Management

# Start Ollama service
ollama serve

# Run as systemd service (Linux)
sudo systemctl enable ollama
sudo systemctl start ollama
sudo systemctl status ollama

# Check service logs
journalctl -u ollama -f

Troubleshooting

Common Issues

CONNECTION REFUSED Check if Ollama service is running: ps aux | grep ollama
Restart service: ollama serve
OUT OF MEMORY Try smaller models (7B instead of 13B/70B)
Increase system swap space
Close other applications
GPU NOT DETECTED Install NVIDIA drivers and CUDA toolkit
Check: nvidia-smi
Restart Ollama after driver installation

Diagnostic Commands

# Check Ollama version
ollama --version

# Check system resources
free -h
df -h
nvidia-smi

# Test API connectivity
curl http://localhost:11434/api/tags

# Check model status
ollama ps

# View logs (Linux)
journalctl -u ollama --no-pager

# View logs (Windows)
Get-EventLog -LogName Application -Source Ollama

Performance Optimization

TIP Optimization Tips:
• Use SSD storage for model files
• Ensure sufficient RAM (8GB+ for 7B models)
• Enable GPU acceleration when available
• Adjust context window size based on use case
• Use model quantization for lower memory usage

Network Configuration

# Allow external connections
export OLLAMA_HOST=0.0.0.0:11434
ollama serve

# Configure firewall (Ubuntu)
sudo ufw allow 11434

# Test remote connection
curl http://your-server-ip:11434/api/tags