Metadata-Version: 2.2
Name: runllama
Version: 0.2.0
Summary: Simple CLI runner for Ollama (LLM) models
Author: Believe Manasseh
Author-email: Manasseh <believemanasseh@gmail.com>
Maintainer-email: Manasseh <believemanasseh@gmail.com>
License: MIT
Project-URL: homepage, https://github.com/believemanasseh/RunLlama
Project-URL: issues, https://github.com/believemanasseh/RunLlama/issues
Keywords: ollama,llama,large language model (LLM),ai,artificial intelligence,machine learning,natural language processing (NLP),conversational ai
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: ollama==0.4.7
Requires-Dist: click==8.1.8
Dynamic: author
Dynamic: classifier
Dynamic: requires-python

# RunLlama

Simple CLI tool for [Ollama (LLM) models](https://ollama.com/search).

[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/yandex/perforator/blob/main/LICENSE)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/runllama?logo=pypi&style=flat&color=blue)](https://pypi.org/project/runllama/)
[![PyPI Version](https://img.shields.io/pypi/v/runllama.svg)](https://pypi.org/project/runllama/)

## Installation

Install via pip:

```bash
pip install runllama
```

Or with Poetry:

```bash
poetry add runllama
```

Run the CLI:

```bash
runllama --help
```

## For Development

Build and run ollama server docker container

```bash
docker build -t runllama .
docker run -d -p 11434:11434 -v ollama:/app/.ollama --name runllama runllama 
```

Install dependencies

```bash
poetry install
poetry shell
```

Run Python script

```bash
python src/main.py --help
```

## Testing

Before running Pytest, ensure the ollama server is running on port 11434.

```bash
pytest -v -s tests/test_*
```

## License

The source code is licensed under the MIT License (see [LICENSE](LICENSE)).
