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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6a7a6e93a9b555caba420b59560ec28d17ca03e751aeeda88c291e7120c074dc
|
|
| MD5 |
73b6c1cf366562ef68be5220a597d3cd
|
|
| BLAKE2b-256 |
9a148cf8002961d89def7af2cc34fc53dc0c3a0075f0506e0e38b64306ffefb8
|
File details
Details for the file ollama_tool_cli-1.2.0-py3-none-any.whl.
File metadata
- Download URL: ollama_tool_cli-1.2.0-py3-none-any.whl
- Upload date:
- Size: 6.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
371fb04c076b51141d6078a28e5b2c589e794dba4448fcc6cba377a07e50b5b6
|
|
| MD5 |
5fbb345d299bb912778583400d67aab6
|
|
| BLAKE2b-256 |
eebc31793f066717549d9339b6fb9252c3d2264edce7e62b8ae24b528f22de26
|