orun-py 1.2.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), built-in screenshot analysis, and 200+ prompt/strategy templates.

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.
• Prompt Templates: 200+ pre-defined templates for coding, analysis, writing, and more.
• Strategy Templates: Chain-of-Thought, Tree-of-Thought, and other reasoning strategies.
• 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

Prompt & Strategy Templates

Use a prompt template:

orun "Review this code" -p review_code
orun "Analyze this paper" -p analyze_paper

Use a reasoning strategy:

orun "Explain step by step" -s cot
orun "Explore multiple approaches" -s tot

Combine prompt and strategy:

orun "Debug this issue" -p analyze_incident -s cod

List available templates:

orun prompts      # List all prompt templates
orun strategies   # List all strategy templates

In chat mode, apply templates dynamically:

/prompt analyze_paper
/strategy cot

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