Skip to main content

CLI tool for managing Ollama models - backup, restore, update, and list models

Project description

Ollama Tool CLI 🦙

A modern CLI tool for managing Ollama models - backup, restore, update, and list your models with ease.

Installation

Using uv

uv add ollama-tool-cli

From source

git clone https://github.com/arian24b/ollamatools.git
cd ollamatools
uv sync

Requirements

  • Python 3.10 or higher
  • Ollama installed and running

Usage

Basic Commands

# Show help
ollama-tool-cli

# List all installed models
ollama-tool-cli list

# Update all models
ollama-tool-cli update

# Update a specific model
ollama-tool-cli update llama3.2

# Backup all models to default location (~/Downloads/ollama_model_backups)
ollama-tool-cli backup

# Backup to custom path
ollama-tool-cli backup --path /path/to/backup

# Backup a specific model
ollama-tool-cli backup --model llama3.2

# Backup with parallel jobs
ollama-tool-cli backup --jobs 4

# Run backup in background
ollama-tool-cli backup --background

# Restore from backup
ollama-tool-cli restore /path/to/backup.zip

# Restore all backups in a directory
ollama-tool-cli restore /path/to/backup_dir

# Show installation information and version
ollama-tool-cli info

# Show log paths
ollama-tool-cli logs

# Follow logs
ollama-tool-cli logs --follow

Command Details

list

Display all installed Ollama models with their versions.

update [model]

Update one or all Ollama models. If no model name is provided, updates all models.

  • --jobs, -j: Number of parallel jobs
  • --background, -b: Run command in background

backup [--path PATH] [--model MODEL]

Backup Ollama models to zip files. By default backs up all models to ~/Downloads/ollama_model_backups.

  • --path, -p: Custom backup directory path
  • --model, -m: Backup only a specific model
  • --jobs, -j: Number of parallel jobs
  • --background, -b: Run command in background

restore <path>

Restore Ollama models from a backup zip file or directory.

  • --jobs, -j: Number of parallel jobs
  • --background, -b: Run command in background

info

Show detailed Ollama installation information including version, models path, platform, and number of installed models.

logs

Show log file locations or follow logs.

  • --follow, -f: Follow the log output

Background logs

Background commands write to an OS-specific log directory with size-based rotation:

  • macOS: ~/Library/Logs/ollama-tool-cli/
  • Linux: ${XDG_STATE_HOME:-~/.local/state}/ollama-tool-cli/logs/
  • Windows: %LOCALAPPDATA%\ollama-tool-cli\Logs\

Development

Setup development environment

uv sync

Build the package

uv build

License

MIT License - see LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ollama_tool_cli-1.2.0.tar.gz (6.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ollama_tool_cli-1.2.0-py3-none-any.whl (6.4 kB view details)

Uploaded Python 3

File details

Details for the file ollama_tool_cli-1.2.0.tar.gz.

File metadata

  • Download URL: ollama_tool_cli-1.2.0.tar.gz
  • Upload date:
  • Size: 6.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for ollama_tool_cli-1.2.0.tar.gz
Algorithm Hash digest
SHA256 6a7a6e93a9b555caba420b59560ec28d17ca03e751aeeda88c291e7120c074dc
MD5 73b6c1cf366562ef68be5220a597d3cd
BLAKE2b-256 9a148cf8002961d89def7af2cc34fc53dc0c3a0075f0506e0e38b64306ffefb8

See more details on using hashes here.

File details

Details for the file ollama_tool_cli-1.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for ollama_tool_cli-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 371fb04c076b51141d6078a28e5b2c589e794dba4448fcc6cba377a07e50b5b6
MD5 5fbb345d299bb912778583400d67aab6
BLAKE2b-256 eebc31793f066717549d9339b6fb9252c3d2264edce7e62b8ae24b528f22de26

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page