Awesome
Deprecated please see ramalama instead:
We are writing a new version of this tool that will support ollama registry, OCI registry and hugging face repos:
https://github.com/containers/ramalama
this uses llama.cpp directly.
podman-ollama is somewhat deprecated although we will accept contributions.
podman-ollama
The goal of podman-ollama is to make AI even more boring.
podman pulls the runtime environment. ollama pulls the model library.
Install
Install podman-ollama by running this one-liner:
curl -fsSL https://raw.githubusercontent.com/ericcurtin/podman-ollama/s/install.sh | sudo bash
Usage
If podman-ollama is passed text it is a non-interactive tool:
$ podman-ollama "Write a git commit message for this diff: $(git diff)"
`Fixed formatting in README.md`
This commit message provides a brief description of the changes made in
the file, and is written in a format that is easy to understand and use.
If podman-ollama is run without any arguments it is an interactive tool:
$ podman-ollama
>>> Tell me about podman in less than ten words
Podman: Containerized application management.
>>> Send a message (/? for help)
Full usage help:
$ podman-ollama -h
The goal of podman-ollama is to make AI even more boring.
Usage:
podman-ollama [prompt]
podman-ollama [options]
podman-ollama [command]
Commands:
serve Start ollama server (not required)
create Create a model from a Modelfile
chatbot Set up chatbot UI interface
open-webui Set up open-webui UI interface
show Show information for a model
run Run a model, default if no command is specified
pull Pull a model from a registry
push Push a model to a registry
list List models
cp Copy a model
rm Remove a model
help Help about any command
generate Generate structured data based on containers, pods or volumes
Options:
-c, --container-manager CONMAN - Specify podman or docker, default: podman
-g, --gpu GPU - Specify a GPU: AMD, NVIDIA, GPU or CPU
-h, --help - Usage help
-l, --log LOGFILE - Specify logfile to redirect to, for GPU debug
-m, --model MODEL - Specify non-default model, default: mistral
--privileged - Give extended privileges to container
-p, --publish - Publish a container's port to the host
-r, --root - Run as a rootful container
-v, --version - Show version information
- - Read from stdin
Environment Variables:
OLLAMA_HOST The host:port or base URL of the Ollama server
(e.g. http://some_remotehost:11434)
Configuration:
podman-ollama uses a simple text format to store customizations that are per
user in "~/.podman-ollama/config". Such a configuration file may look like
this:
container-manager podman
gpu GPU
model gemma:2b
Import from GGUF:
podman-ollama supports importing GGUF models in the Modelfile:
-
Create a file named
Modelfile
, with aFROM
instruction with the local filepath to the model you want to import.FROM https://huggingface.co/instructlab/granite-7b-lab-GGUF/resolve/main/granite-7b-lab-Q4_K_M.gguf
-
Create the model in podman-ollama
podman-ollama create granite-7b-lab-Q4_K_M
-
Run the model
podman-ollama run granite-7b-lab-Q4_K_M