AskOra

AskOra is a unified Python CLI for interacting with multiple AI providers like OpenAI, Ollama, DeepSeek and Anthropic(Claude). Send prompts, get responses, and switch between providers seamlessly, all from the command line.

---

Features

• Single CLI to interact with multiple AI providers
• Supports OpenAI, Ollama, Anthropic(Claude), DeepSeek and more in the future
• Returns structured responses with tokens used and execution time
• Supports sync and async execution
• Clean error handling for missing models, invalid API keys, etc.
• Available on PyPI as askora

---

Installation

Clone the repo and install dependencies:

git clone https://github.com/jetroni/askora.git
cd askora
python -m venv .venv
source .venv/bin/activate   # On Windows: .venv\Scripts\activate
pip install -r requirements.txt

Or install directly from PyPI:

pip install askora

(Optional) Make the CLI globally executable:

pip install --editable .

---

Usage

Basic usage:

askora --type openai --prompt "Hello AI"

Run with async mode:

askora --type openai --prompt "Hello AI" --async-mode

Ollama example (with base URL):

askora --type ollama --base-url http://localhost:11434 --model codellama --prompt "Hello"

---

CLI Options

Option	Description
--type	AI provider type (openai, ollama)
--prompt	Text prompt to send to the AI
--key	API key for providers that require authentication
--model	Model name to use (defaults vary per provider)
--base-url	Base URL for self-hosted providers like Ollama
--async-mode	Run asynchronously (flag, no value needed)

---

Response Structure

All responses are returned as a structured JSON object:

{
  "provider": "openai",
  "model": "gpt-4o-mini",
  "output": "Hello! How can I assist you today?",
  "raw": {...},
  "tokens_used": 17,
  "duration_ms": 543
}

---

Contributing

We welcome contributions!

• Add support for new AI providers
• Improve error handling
• Enhance async execution and CLI experience

Please fork the repo and submit a pull request.

---

License

MIT License. Free to use and modify.

---

PyPI

AskOra is published on PyPI. Install via:

pip install askora

Stay up to date with the latest releases and check the package page: https://pypi.org/project/askora/