orun-py 1.0.0

Add your description here

orun-py

A Python CLI wrapper for interacting with local LLMs via Ollama, featuring built-in support for analyzing screenshots.

Features

• Quick AI Queries: Send prompts to your local LLMs directly from the terminal.
• Screenshot Analysis: Automatically detect and attach the most recent screenshots from your user Pictures folder to your query.
• Chat Mode: Maintain a continuous conversation session.
• Model Management: Easily switch between different configured Ollama models using aliases.

Installation

pip install orun-py

Usage

The main command is orun.

Basic Query

orun "Why is the sky blue?"

Analyze Screenshots

By default, the -i flag grabs the most recent screenshot.

orun "What is this error?" -i

Analyze the last 3 screenshots:

orun "Compare these images" -i 3x

Select specific screenshots by index (1 is the newest):

orun "Look at the first and third image" -i 1 3

Chat Mode

Start an interactive session:

orun --chat

Start chat with an initial prompt and image:

orun "Help me debug this" -i --chat

Select Model

Use a specific model alias (configured in orun/main.py):

orun "Write python code" -m coder

List available models:

orun --list-models

Requirements

• Python 3.12+
• Ollama running locally