askora 0.0.1

A unified CLI for AI providers like OpenAI and Ollama

askora

askora is a unified Python CLI for interacting with multiple AI providers like OpenAI and Ollama. 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, 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.

---

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

(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.com --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.