Apply Ruff formatting from pre-commit hook

.github/workflows/ruff.yml

@@ -0,0 +1,23 @@
+name: Ruff
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.11'
+      - name: Install ruff
+        run: |
+          python -m pip install --upgrade pip
+          pip install ruff
+      - name: Run ruff check
+        run: ruff check .

.pre-commit-config.yaml

@@ -0,0 +1,6 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.0
+    hooks:
+      - id: ruff-check
+      - id: ruff-format

Makefile

@@ -0,0 +1,26 @@
+
+.PHONY: lint format test add-dev
+
+# write help 
+help:
+	@echo "Available commands:"
+	@echo "  lint      - Run linters"
+	@echo "  format    - Format code"
+	@echo "  test      - Run tests"
+	@echo "  add-dev   - Add development dependencies"
+
+# Use uv to run tools in the project's environment. Example:
+#   uv add --dev ruff
+
+lint:
+	uv ruff check .
+
+format:
+	uv ruff format .
+
+add-dev:
+	# Add ruff to the project's dev tools using uv
+	uv add --dev ruff
+
+test:
+	python -m pytest -q

README.md

@@ -189,3 +189,37 @@ except ollama.ResponseError as e:
   if e.status_code == 404:
     ollama.pull(model)
 ```
+
+## Contributing / Linting
+
+
+We use Ruff for linting and formatting. This project uses uv for managing dev tools. Recommended commands:
+
+```sh
+# add ruff to the project dev tools (adds to uv config)
+uv add --dev ruff
+
+# lint
+uv ruff check .
+
+# format in-place
+uv ruff format .
+```
+
+Alternatives: install Ruff globally with `pipx`, `pip`, or Homebrew if you prefer.
+
+Pre-commit hooks are provided. To enable them locally:
+
+```sh
+pip install --upgrade pre-commit
+pre-commit install
+pre-commit run --all-files
+```
+
+There's also a Makefile with convenient targets:
+
+```sh
+make lint
+make format
+```
+

ollama/__init__.py

@@ -1,3 +1,8 @@
+"""Ollama Python client package.
+
+Convenience exports for the top-level API.
+"""
+
 from ollama._client import AsyncClient, Client
 from ollama._types import (
   ChatResponse,