orun-py 1.0.2

Add your description here

orun-py

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

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.
• Conversation History: All conversations are saved locally and can be continued later.
• Model Management: Easily switch between different configured Ollama models using aliases.

Installation

pip install orun-py

Usage

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:

orun "Write python code" -m coder

List available models:

orun models

Conversation History

List recent conversations:

orun history

Continue a conversation by ID:

orun c 1

Continue the last conversation:

orun last

Requirements

• Python 3.12+
• Ollama running locally