Metadata-Version: 2.4
Name: ollama-installer
Version: 0.1.0
Summary: Install Ollama from a Python CLI.
Author: Yu,Yao-Hsing
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Topic :: System :: Installation/Setup
Requires-Python: >=3
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: license
Dynamic: license-file
Dynamic: requires-python
Dynamic: summary

# ollama-installer

`ollama-installer` is the PyPI distribution name for a small Python package
that adds a `python-ollama` command. Its main goal is to install
Ollama from Python without stopping at a simple installer download.

When you run `python-ollama install`, the package downloads and executes the
official Ollama installation script for the current platform:

- Windows: `https://ollama.com/install.ps1`
- Linux and macOS: `https://ollama.com/install.sh`

## Features

- Installs Ollama with a single command: `python-ollama install`
- Supports Windows, Linux, and macOS
- Supports version pinning with `--version`
- Supports `--dry-run` so you can inspect the install plan first
- Uses only the Python standard library
- Keeps the implementation compatible with Python 3

## Installation

Install from the repository:

```bash
pip install .
```

Install from PyPI after publishing:

```bash
pip install ollama-installer
```

Install for the current user on Windows:

```bash
pip install --user .
```

If `python-ollama` is not found in `cmd`, add the user Scripts directory to
your `PATH`. On Windows this is usually:

```text
%APPDATA%\Python\PythonXY\Scripts
```

## Usage

Install the latest Ollama release:

```bash
python-ollama install
```

Install a specific version:

```bash
python-ollama install --version 0.7.2
```

Preview the resolved install plan without changing the system:

```bash
python-ollama install --dry-run
```

Request a custom install directory when the official installer supports it:

```bash
python-ollama install --install-dir C:\Ollama
```

Enable verbose installer output:

```bash
python-ollama install --debug
```

## Development

Run the test suite:

```bash
python -m unittest discover -s tests -v
```

Build a wheel:

```bash
python -m pip wheel . -w dist
```

## Repository Layout

- `python_ollama/`: package source code
- `tests/`: unit tests
- `setup.py`: packaging metadata and CLI entry point
- `MANIFEST.in`: source distribution file list

## Notes

- Actual installation work is delegated to the official Ollama scripts.
- Administrator or sudo permissions may still be required by the host system.
- This project is an unofficial helper package for installing Ollama.
