llmworker 0.1.3

A lightweight Python toolkit for LLM text and image workflows with Ollama.

LLMWorker

LLMWorker is a minimal Python library to centralize LLM operations behind reusable workers.

Included Components

• OllamaClient: low-level client for Ollama HTTP endpoints.
• TextWorker: helper class for text generation/chat style requests.
• ImageWorker: helper class for image generation requests.

Quick Start

bash scripts/bootstrap.sh
python scripts/demo.py

Build Package

bash scripts/build.sh

Check Package Name (PyPI)

Before publishing, validate that your package name is free:

python scripts/check_name.py llmworker

If it is taken, choose a new name (for example llmworker-sergio) and update it in pyproject.toml.

Install As A Package

Install from source (non-editable):

pip install .

Install from wheel artifact:

bash scripts/build.sh
pip install dist/*.whl

Install from PyPI (after you publish):

pip install llmworker

Install (editable)

pip install -e .

Publish To PyPI

Don't forget to check / change the project version on pyproject.toml. (example:)

version = "0.1.3"

bash scripts/publish.sh

Recommended release flow:

python scripts/check_name.py llmworker
bash scripts/build.sh
bash scripts/publish.sh

Basic Usage

from llmworker import OllamaClient, TextWorker, ImageWorker

client = OllamaClient(base_url="http://localhost:11434")
text_worker = TextWorker(client, model="llama3.2:3b")
image_worker = ImageWorker(client, model="x/flux2-klein:latest")

answer = text_worker.generate("Explain the origin of universe in one paragraph.")
print(answer)

Example image generation (model must support images)
img_result = image_worker.generate_image("A futuristic city at sunset")
print(img_result)

PIP install from GitHub

To install directly from GitHub, use the following command

pip install "git+https://github.com/sergio-ildefonso/LLMWorker.git@v0.1.3"