orun-py 1.2.1

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).
• arXiv Integration: Search and retrieve academic papers directly from arXiv.
• 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

arXiv Integration

Search for academic papers and let the AI analyze them:

orun "Find recent papers about transformers in NLP"
orun "Get details about arXiv paper 1706.03762"
orun "Search for papers by Geoffrey Hinton and summarize his latest work"

In interactive chat, use the /arxiv command for direct access:

orun chat
> /arxiv quantum computing
> /arxiv 1706.03762
> /arxiv https://arxiv.org/abs/2301.07041

The AI can autonomously:

• Search arXiv by keywords, topics, or authors
• Retrieve full paper details (title, abstract, authors, PDF links)
• Analyze and summarize research papers
• Find relevant literature for your projects

The /arxiv command automatically detects whether you're searching or requesting a specific paper, fetches the data, and provides AI analysis without showing raw output.

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