orun-py 1.1.0

Add your description here

orun-py

A Python CLI Agent wrapper for Ollama. It combines chat capabilities with autonomous tools (file I/O, shell execution, web fetching) and built-in screenshot analysis.

Features

• Autonomous Agent: Can read/write files, run shell commands, and fetch URLs (with user confirmation).
• Screenshot Analysis: Auto-detects and attaches recent screenshots from your Pictures folder.
• Conversation History: SQLite-backed history lets you resume any session.
• Model Management: Sync models from Ollama and manage shortcuts.

Installation

pip install orun-py

Usage

Agent & Query

Ask a question or give a task. The AI will use tools if necessary.

orun "Why is the sky blue?"
orun "Scan the current directory and list all Python files"
orun "Read src/main.py and explain how it works"

Interactive Chat

Start a continuous session:

orun chat

Start chat with a specific model:

orun chat -m coder

Analyze Screenshots

Attach the most recent screenshot:

orun "What is this error?" -i

Attach the last 3 screenshots:

orun "Compare these images" -i 3x

Model Management

Sync models from Ollama:

orun refresh

List available models:

orun models

Set default active model:

orun set-active llama3.1

Create a shortcut:

orun shortcut llama3.1:8b l3

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