orun-py 1.2.3

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, search the web, and fetch URLs (with user confirmation).
• Web Search: Google Custom Search API (with DuckDuckGo fallback) for internet searches.
• URL Fetching: Jina AI Reader converts web pages to clean markdown optimized for LLM analysis.
• 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.

Web Search & URL Fetching

Search the web or fetch specific web pages in interactive chat:

Web Search (Google/DuckDuckGo):

orun chat
> /search Python asyncio tutorials
> /search latest news about AI

Fetch URL (via Jina AI Reader):

orun chat
> /fetch https://example.com
> /fetch github.com/user/repo

Configure Google Custom Search API (optional):

# Get API key from https://console.cloud.google.com/
# Get CSE ID from https://programmablesearchengine.google.com/
orun config-search YOUR_API_KEY YOUR_CSE_ID

# View current configuration
orun config-search

Features:

• Web Search: Google Custom Search API (100 free queries/day) with DuckDuckGo fallback
• URL Fetching: Jina AI Reader converts pages to clean markdown optimized for LLM analysis
• Automatic Fallback: If Google quota exceeded, automatically uses DuckDuckGo
• AI Analysis: All results are analyzed and summarized by the AI

The AI can also autonomously call web_search() and fetch_url() tools during conversations.

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