askcii 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18a37a3681323f04071f337d1b0e8f7b0351fe2879de62224951d4b4c8c7d8d4
-  data.tar.gz: 3e994f5ea755fed88a74fd07be374a412825c8e2227cc048f5c2d2dc219d2b5b
+  metadata.gz: fdbabf6bbd313aa11a7868b5df4630a85798e6a59311872bc04cebeaa2ac49e3
+  data.tar.gz: cff4449b247c8dcfe5273e122b054d72e54f57866f905854fd94aa39ee8e8547
 SHA512:
-  metadata.gz: 9c7c23cc79eb32819c310774894800f6f77cde9fa8466ac4f5674ebeaa626b006f39a487a8d99b8324b9e152a2f8393ecea0c61a9c1e822148c63732c4e9ea64
-  data.tar.gz: e10d8a1726d612e6aeab85aaf717d48d6616eac31dcd744b56a761fad2e0ce71c1f8ad4e2e574590817e1c6a1b12f87c772793a72d1747e69095c9868547e548
+  metadata.gz: 5ca4009158417d0eee5a4452c4ec5c49fefedabdeb22495a2f6b6d08136391f19535e9468113c164f714e0a382eb8b57244e56027d6b824f23132fea679a4d29
+  data.tar.gz: ee32e1ab823d7a2dc53445e3fa7cf064993272571512f6c4b18966bbb08c87163158262387521d073d5bfa0c158f80b8ab808f05c98f8e330aaaa555122814f2

data/Gemfile.lock

@@ -1,9 +1,9 @@
 PATH
   remote: .
   specs:
-    askcii (0.1.0)
+    askcii (0.3.0)
       amalgalite (~> 1.9)
-      ruby_llm (= 1.3.0rc1)
+      ruby_llm (= 1.5.1)
       sequel (~> 5.92)
 
 GEM
@@ -14,6 +14,7 @@ GEM
     arrayfields (4.9.2)
     base64 (0.2.0)
     bigdecimal (3.1.9)
+    csv (3.3.5)
     event_stream_parser (1.0.0)
     faraday (2.13.1)
       faraday-net_http (>= 2.0, < 3.5)
@@ -27,18 +28,21 @@ GEM
       faraday (~> 2.0)
     json (2.12.0)
     logger (1.7.0)
+    marcel (1.0.4)
     minitest (5.25.5)
     multipart-post (2.4.1)
     net-http (0.6.0)
       uri
+    ostruct (0.6.3)
     rake (13.2.1)
-    ruby_llm (1.3.0rc1)
+    ruby_llm (1.5.1)
       base64
       event_stream_parser (~> 1)
-      faraday (~> 2)
-      faraday-multipart (~> 1)
-      faraday-net_http (~> 3)
-      faraday-retry (~> 2)
+      faraday (>= 1.10.0)
+      faraday-multipart (>= 1)
+      faraday-net_http (>= 1)
+      faraday-retry (>= 1)
+      marcel (~> 1.0)
       zeitwerk (~> 2)
     sequel (5.92.0)
       bigdecimal
@@ -59,7 +63,9 @@ PLATFORMS
 
 DEPENDENCIES
   askcii!
+  csv (~> 3.0)
   minitest (~> 5.25)
+  ostruct (~> 0.6)
   rake (~> 13.0)
 
 BUNDLED WITH

data/README.md

@@ -1,6 +1,6 @@
 # Askcii
 
-A command-line application for interacting with LLM models in a terminal-friendly way.
+A command-line application for interacting with multiple LLM providers in a terminal-friendly way. Supports OpenAI, Anthropic, Gemini, DeepSeek, OpenRouter, and Ollama with multi-configuration management.
 
 ## Installation
 
@@ -20,52 +20,198 @@ Or install it yourself as:
 
 ## Usage
 
-```
+### Basic Usage
+
+```bash
 # Basic usage
 askcii 'Your prompt here'
 
-# Pipe input
-echo 'Your context text' | askcii 'Your prompt here'
+# Pipe input from other commands
+echo 'Your context text' | askcii 'Analyze this text'
 
 # File input
-askcii 'Your prompt here' < input.txt
+askcii 'Summarize this document' < document.txt
+
+# Private session (no conversation history saved)
+askcii -p 'Tell me a joke'
+
+# Get the last response from your current session
+askcii -r
+
+# Use a specific configuration
+askcii -m 2 'Hello using configuration 2'
+```
+
+### Session Management
 
+```bash
 # Set a custom session ID to maintain conversation context
-ASKCII_SESSION_ID="project-research" askcii 'What did we talk about earlier?'
+ASKCII_SESSION="project-research" askcii 'What did we talk about earlier?'
 
-# Or add the following to your .bashrc or .zshrc to always start a new session
+# Generate a new session for each terminal session
 export ASKCII_SESSION=$(openssl rand -hex 16)
+```
+
+### Command Line Options
+
+```
+Usage: askcii [options] 'Your prompt here'
+
+Options:
+  -p, --private         Start a private session and do not record
+  -r, --last-response   Output the last response
+  -c, --configure       Manage configurations
+  -m, --model ID        Use specific configuration ID
+  -h, --help            Show help
+```
+
+## Configuration Management
+
+Askcii supports multi-configuration management, allowing you to easily switch between different LLM providers and models.
 
-# Configure the API key, endpoint, and model ID
+### Interactive Configuration
+
+Use the `-c` flag to access the configuration management interface:
+
+```bash
 askcii -c
+```
 
-# Get the last response
-askcii -r
+This will show you a menu like:
+
+```
+Configuration Management
+=======================
+Current configurations:
+  1. GPT-4 [openai] (default)
+  2. Claude Sonnet [anthropic]
+  3. Gemini Pro [gemini]
+  4. Local Llama [ollama]
+
+Options:
+  1. Add new configuration
+  2. Set default configuration
+  3. Delete configuration
+  4. Exit
 ```
 
-## Configuration
+### Supported Providers
+
+1. **OpenAI** - GPT models (gpt-4, gpt-3.5-turbo, etc.)
+2. **Anthropic** - Claude models (claude-3-sonnet, claude-3-haiku, etc.)
+3. **Gemini** - Google's Gemini models
+4. **DeepSeek** - DeepSeek models
+5. **OpenRouter** - Access to multiple models through OpenRouter
+6. **Ollama** - Local models (no API key required)
 
-You can configure your API key, endpoint, and model ID using the `-c` option:
+### Adding a New Configuration
 
+When adding a configuration, you'll be prompted for:
+
+1. **Configuration name** - A friendly name for this configuration
+2. **Provider** - Choose from the supported providers
+3. **API key** - Your API key for the provider (not needed for Ollama)
+4. **API endpoint** - The API endpoint (defaults provided for each provider)
+5. **Model ID** - The specific model to use
+
+Example for OpenAI:
 ```
-$ askcii -c
-Configuring askcii...
-Enter API key: your_api_key_here
-Enter API endpoint: http://localhost:11434/v1
-Enter model ID: gemma3:12b
-Configuration saved successfully!
+Enter configuration name: GPT-4 Turbo
+Provider (1-6): 1
+Enter OpenAI API key: sk-your-api-key-here
+Enter API endpoint (default: https://api.openai.com/v1): [press enter for default]
+Enter model ID: gpt-4-turbo-preview
 ```
 
-Configuration settings are stored in a SQLite database located at `~/.local/share/askcii/askcii.db`.
+Example for Ollama (local):
+```
+Enter configuration name: Local Llama
+Provider (1-6): 6
+Enter API endpoint (default: http://localhost:11434/v1): [press enter for default]
+Enter model ID: llama3:8b
+```
+
+### Using Configurations
+
+```bash
+# Use the default configuration
+askcii 'Hello world'
 
-You can also use environment variables to override the stored configuration:
+# Use a specific configuration by ID
+askcii -m 2 'Hello using configuration 2'
 
+# List all configurations
+askcii -c
 ```
+
+### Configuration Storage
+
+Configuration settings are stored in a SQLite database located at `~/.local/share/askcii/askcii.db`.
+
+### Environment Variable Fallback
+
+You can still use environment variables as a fallback when no configurations are set up:
+
+```bash
 ASKCII_API_KEY="your_api_key" askcii 'Hello!'
 ASKCII_API_ENDPOINT="https://api.example.com/v1" askcii 'Hello!'
 ASKCII_MODEL_ID="gpt-4" askcii 'Hello!'
 ```
 
+## Examples
+
+### Daily Workflow Examples
+
+```bash
+# Code review
+git diff | askcii 'Review this code change and suggest improvements'
+
+# Log analysis
+tail -100 /var/log/app.log | askcii 'Summarize any errors or issues'
+
+# Documentation
+askcii 'Explain how to set up a Redis cluster' > redis-setup.md
+
+# Quick calculations
+askcii 'Calculate compound interest: $1000 at 5% for 10 years'
+
+# Text processing
+cat customers.csv | askcii 'Convert this CSV to JSON format'
+```
+
+### Multi-Provider Usage
+
+```bash
+# Use Claude for creative writing
+askcii -m 1 'Write a short story about AI'
+
+# Use GPT-4 for code analysis
+askcii -m 2 'Explain this Python function' < function.py
+
+# Use local Ollama for private data
+askcii -m 3 -p 'Analyze this sensitive document' < confidential.txt
+```
+
+## Session Management
+
+Askcii maintains conversation history unless you use the private mode (`-p`). Sessions are identified by:
+
+1. The `ASKCII_SESSION` environment variable
+2. A randomly generated session ID if not specified
+
+```bash
+# Start a named session for a project
+export ASKCII_SESSION="project-alpha"
+askcii 'What is the project timeline?'
+askcii 'What are the main risks?' # This will have context from previous question
+
+# Use private mode for one-off questions
+askcii -p 'What is the weather like?'
+
+# Get the last response from current session
+askcii -r
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/Rakefile

@@ -1,8 +1,24 @@
 # frozen_string_literal: true
 
 require 'bundler/gem_tasks'
-require 'rspec/core/rake_task'
+require 'rake/testtask'
 
-RSpec::Core::RakeTask.new(:spec)
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/*_test.rb']
+end
 
-task default: :spec
+Rake::TestTask.new(:comprehensive) do |t|
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/comprehensive_test.rb']
+end
+
+Rake::TestTask.new(:simple) do |t|
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/simple_test.rb']
+end
+
+task default: :comprehensive

data/askcii.gemspec

@@ -6,7 +6,7 @@ Gem::Specification.new do |spec|
   spec.name          = 'askcii'
   spec.version       = Askcii::VERSION
   spec.authors       = ['Roel Bondoc']
-  spec.email         = ['roelbondoc@example.com']
+  spec.email         = ['rsbondoc@gmail.com']
 
   spec.summary       = 'Command line application for LLM interactions'
   spec.description   = 'A terminal-friendly interface for interacting with LLM models'
@@ -26,10 +26,12 @@ Gem::Specification.new do |spec|
   spec.executables   = ['askcii']
   spec.require_paths = ['lib']
 
-  spec.add_dependency 'sequel', '~> 5.92'
   spec.add_dependency 'amalgalite', '~> 1.9'
-  spec.add_dependency 'ruby_llm', '1.3.0rc1'
+  spec.add_dependency 'ruby_llm', '1.5.1'
+  spec.add_dependency 'sequel', '~> 5.92'
 
+  spec.add_development_dependency 'csv', '~> 3.0'
   spec.add_development_dependency 'minitest', '~> 5.25'
+  spec.add_development_dependency 'ostruct', '~> 0.6'
   spec.add_development_dependency 'rake', '~> 13.0'
 end

data/bin/askcii

@@ -4,99 +4,9 @@
 # Find the right load path
 $LOAD_PATH.unshift File.expand_path('../lib', __dir__)
 require 'askcii'
-require 'optparse'
 
 Askcii.setup_database
-Askcii.configure_llm
 Askcii.require_models
+Askcii.require_application
 
-# Parse command-line options
-options = {}
-opt_parser = OptionParser.new do |opts|
-  opts.banner = "Usage: askcii [options] 'Your prompt here'"
-
-  opts.on('-r', '--last-response', 'Output the last response') do
-    options[:last_response] = true
-  end
-
-  opts.on('-c', '--configure', 'Configure API key, endpoint, and model ID') do
-    options[:configure] = true
-  end
-
-  opts.on('-h', '--help', 'Show this help message') do
-    puts opts
-    exit
-  end
-end
-
-# Parse options, keeping remaining arguments in ARGV
-opt_parser.parse!
-
-# Handle configuration if requested
-if options[:configure]
-  puts 'Configuring askcii...'
-
-  # Prompt for API key
-  print 'Enter API key: '
-  api_key = gets.chomp
-
-  # Prompt for API endpoint
-  print "Enter API endpoint: "
-  api_endpoint = gets.chomp
-
-  # Prompt for model ID
-  print 'Enter model ID: '
-  model_id = gets.chomp
-
-  # Save configuration to database
-  Askcii::Config.set('api_key', api_key) unless api_key.empty?
-  Askcii::Config.set('api_endpoint', api_endpoint) unless api_endpoint.empty?
-  Askcii::Config.set('model_id', model_id) unless model_id.empty?
-
-  puts 'Configuration saved successfully!'
-  exit 0
-end
-
-context = ENV['ASKCII_SESSION']
-model_id = Askcii::Config.model_id || ENV['ASKCII_MODEL_ID']
-chat = Askcii::Chat.find_or_create(context: context, model_id: model_id).to_llm
-
-# Output last response if requested
-if options[:last_response]
-  last_message = chat.messages.where(role: 'assistant').last
-  if last_message
-    puts last_message.content
-    exit 0
-  else
-    puts 'No previous response found.'
-    exit 1
-  end
-end
-
-# Process input
-input = nil
-input = $stdin.read unless $stdin.tty?
-
-prompt = ARGV.join(' ')
-
-if prompt.empty?
-  puts 'Usage:'
-  puts "  askcii [options] 'Your prompt here'"
-  puts "  echo 'Your prompt here' | askcii 'Your prompt here'"
-  puts "  askcii 'Your prompt here' < prompt.txt"
-  puts '  askcii -r (to get the last response)'
-  puts '  askcii -c (to configure API key, endpoint, and model ID)'
-  puts "\nOptions:"
-  puts '  -r, --last-response   Output the last response'
-  puts '  -c, --configure       Configure API key, endpoint, and model ID'
-  puts '  -h, --help            Show help'
-  exit 1
-end
-
-chat.with_instructions 'You are a command line application. Your responses should be suitable to be read in a terminal. Your responses should only include the necessary text. Do not include any explanations unless prompted for it.'
-prompt = "With the following text:\n\n#{input}\n\n#{prompt}" if input
-
-chat.ask(prompt) do |chunk|
-  print chunk.content
-end
-puts ''
+Askcii::Application.new.run

data/lib/askcii/application.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+require_relative 'cli'
+require_relative 'configuration_manager'
+require_relative 'chat_session'
+
+module Askcii
+  class Application
+    def initialize(args = ARGV.dup)
+      @cli = CLI.new(args)
+    end
+
+    def run
+      @cli.parse!
+
+      if @cli.show_help?
+        puts @cli.help_message
+        exit 0
+      end
+
+      if @cli.configure?
+        ConfigurationManager.new.run
+        exit 0
+      end
+
+      selected_config = determine_configuration
+      configure_llm(selected_config)
+
+      chat_session = ChatSession.new(@cli.options, selected_config)
+      chat_session.handle_last_response if @cli.last_response?
+
+      prompt, input = determine_prompt_and_input
+
+      if prompt.empty? && input.nil?
+        puts @cli.usage_message
+        exit 1
+      end
+
+      chat_session.execute_chat(prompt, input)
+    end
+
+    private
+
+    def determine_configuration
+      if @cli.model_config_id
+        config = Askcii::Config.get_configuration(@cli.model_config_id)
+        return config if config
+      end
+
+      config = Askcii::Config.current_configuration
+      return config if config
+
+      # Fallback to environment variables
+      {
+        'api_key' => ENV['ASKCII_API_KEY'],
+        'api_endpoint' => ENV['ASKCII_API_ENDPOINT'],
+        'model_id' => ENV['ASKCII_MODEL_ID']
+      }
+    end
+
+    def configure_llm(selected_config)
+      Askcii.configure_llm(selected_config)
+    end
+
+    def determine_prompt_and_input
+      stdin_content = read_stdin_input
+
+      if @cli.prompt.empty? && stdin_content
+        # No prompt provided via args, use stdin as prompt
+        [stdin_content.strip, nil]
+      elsif !@cli.prompt.empty? && stdin_content
+        # Both prompt and stdin provided, use stdin as input context
+        [@cli.prompt, stdin_content]
+      else
+        # Only prompt provided (or neither)
+        [@cli.prompt, nil]
+      end
+    end
+
+    def read_stdin_input
+      return nil if $stdin.tty?
+
+      $stdin.read
+    end
+  end
+end

data/lib/askcii/chat_session.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require 'securerandom'
+
+module Askcii
+  class ChatSession
+    def initialize(options, selected_config)
+      @options = options
+      @selected_config = selected_config
+    end
+
+    def handle_last_response
+      return unless @options[:last_response]
+
+      context = ENV['ASKCII_SESSION'] || SecureRandom.hex(8)
+      model_id = @selected_config['model_id']
+      chat_record = Askcii::Chat.find_or_create(context: context, model_id: model_id)
+
+      last_message = chat_record.messages.select { |msg| msg.role == 'assistant' }.last
+      if last_message
+        puts last_message.content
+        exit 0
+      else
+        puts 'No previous response found.'
+        exit 1
+      end
+    end
+
+    def create_chat
+      if @options[:private]
+        create_private_chat
+      else
+        create_persistent_chat
+      end
+    end
+
+    def execute_chat(prompt, input = nil)
+      chat = create_chat
+
+      chat.with_instructions 'You are a command line application. Your responses should be suitable to be read in a terminal. Your responses should only include the necessary text. Do not include any explanations unless prompted for it.'
+
+      full_prompt = input ? "With the following text:\n\n#{input}\n\n#{prompt}" : prompt
+
+      chat.ask(full_prompt) do |chunk|
+        print chunk.content
+      end
+      puts ''
+    end
+
+    private
+
+    def create_private_chat
+      provider_symbol = @selected_config['provider'] ? @selected_config['provider'].to_sym : :openai
+      model_id = @selected_config['model_id']
+
+      RubyLLM.chat(
+        model: model_id,
+        provider: provider_symbol,
+        assume_model_exists: true
+      )
+    end
+
+    def create_persistent_chat
+      context = ENV['ASKCII_SESSION'] || SecureRandom.hex(8)
+      model_id = @selected_config['model_id']
+      chat_record = Askcii::Chat.find_or_create(context: context, model_id: model_id)
+      chat_record.to_llm
+    end
+  end
+end