prescient 0.0.0 → 0.1.0

data/lib/prescient/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Prescient
-  VERSION = "0.0.0"
+  VERSION = '0.1.0'
 end

data/lib/prescient.rb

@@ -1,8 +1,90 @@
 # frozen_string_literal: true
 
-require_relative "prescient/version"
+require_relative 'prescient/version'
 
 module Prescient
   class Error < StandardError; end
-  # Your code goes here...
+  class ConnectionError < Error; end
+  class AuthenticationError < Error; end
+  class RateLimitError < Error; end
+  class ModelNotAvailableError < Error; end
+  class InvalidResponseError < Error; end
+
+  module Provider
+    # Module for AI provider implementations
+  end
+end
+
+require_relative 'prescient/base'
+require_relative 'prescient/provider/ollama'
+require_relative 'prescient/provider/anthropic'
+require_relative 'prescient/provider/openai'
+require_relative 'prescient/provider/huggingface'
+require_relative 'prescient/client'
+
+module Prescient
+  # Configure the gem
+  def self.configure
+    yield(configuration)
+  end
+
+  def self.configuration
+    @_configuration ||= Configuration.new
+  end
+
+  def self.reset_configuration!
+    @_configuration = Configuration.new
+  end
+
+  class Configuration
+    attr_accessor :default_provider
+    attr_accessor :timeout
+    attr_accessor :retry_attempts
+    attr_accessor :retry_delay
+    attr_reader :providers
+
+    def initialize
+      @default_provider = :ollama
+      @timeout = 30
+      @retry_attempts = 3
+      @retry_delay = 1.0
+      @providers = {}
+    end
+
+    def add_provider(name, provider_class, **options)
+      @providers[name.to_sym] = {
+        class:   provider_class,
+        options: options,
+      }
+    end
+
+    def provider(name)
+      provider_config = @providers[name.to_sym]
+      return nil unless provider_config
+
+      provider_config[:class].new(**provider_config[:options])
+    end
+  end
+
+  # Default configuration
+  configure do |config|
+    config.add_provider(:ollama, Prescient::Provider::Ollama,
+                        url:             ENV.fetch('OLLAMA_URL', 'http://localhost:11434'),
+                        embedding_model: ENV.fetch('OLLAMA_EMBEDDING_MODEL', 'nomic-embed-text'),
+                        chat_model:      ENV.fetch('OLLAMA_CHAT_MODEL', 'llama3.1:8b'))
+
+    config.add_provider(:anthropic, Prescient::Provider::Anthropic,
+                        api_key: ENV.fetch('ANTHROPIC_API_KEY', nil),
+                        model:   ENV.fetch('ANTHROPIC_MODEL', 'claude-3-haiku-20240307'))
+
+    config.add_provider(:openai, Prescient::Provider::OpenAI,
+                        api_key:         ENV.fetch('OPENAI_API_KEY', nil),
+                        embedding_model: ENV.fetch('OPENAI_EMBEDDING_MODEL', 'text-embedding-3-small'),
+                        chat_model:      ENV.fetch('OPENAI_CHAT_MODEL', 'gpt-3.5-turbo'))
+
+    config.add_provider(:huggingface, Prescient::Provider::HuggingFace,
+                        api_key:         ENV.fetch('HUGGINGFACE_API_KEY', nil),
+                        embedding_model: ENV.fetch('HUGGINGFACE_EMBEDDING_MODEL', 'sentence-transformers/all-MiniLM-L6-v2'),
+                        chat_model:      ENV.fetch('HUGGINGFACE_CHAT_MODEL', 'microsoft/DialoGPT-medium'))
+  end
 end

data/prescient.gemspec

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require_relative "lib/prescient/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "prescient"
+  spec.version = Prescient::VERSION
+  spec.authors = ["Ken C. Demanawa"]
+  spec.email = ["kenneth.c.demanawa@gmail.com"]
+
+  spec.summary = "Prescient AI provider abstraction for Ruby applications"
+  spec.description = "Prescient provides a unified interface for AI providers including local Ollama, Anthropic Claude, OpenAI GPT, and HuggingFace models. Built for AI applications with error handling, health monitoring, and provider switching."
+  spec.homepage = "https://github.com/yourcompany/prescient"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.0.0"
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/yourcompany/prescient"
+  spec.metadata["changelog_uri"] = "https://github.com/yourcompany/prescient/blob/main/CHANGELOG.md"
+
+  # Specify which files should be added to the gem when it is released.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ spec/ features/ .git .github appveyor Gemfile])
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  # Runtime dependencies
+  spec.add_dependency "httparty", "~> 0.22.0"
+  
+  # Optional dependencies for vector database integration
+  spec.add_development_dependency "pg", "~> 1.5" # PostgreSQL adapter for pgvector integration
+
+  # Development dependencies
+  spec.add_development_dependency "minitest", "~> 5.20"
+  spec.add_development_dependency "mocha", "~> 2.1"
+  spec.add_development_dependency "webmock", "~> 3.18"
+  spec.add_development_dependency "vcr", "~> 6.1"
+  spec.add_development_dependency "rubocop", "~> 1.50"
+  spec.add_development_dependency "rubocop-minitest", "~> 0.35"
+  spec.add_development_dependency "rubocop-performance", "~> 1.19"
+  spec.add_development_dependency "rubocop-rake", "~> 0.6"
+  spec.add_development_dependency "simplecov", "~> 0.22"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "irb"
+end

data/scripts/setup-ollama-models.sh

@@ -0,0 +1,77 @@
+#!/bin/bash
+# Setup script for pulling required Ollama models for Prescient gem
+
+set -e
+
+OLLAMA_URL=${OLLAMA_URL:-"http://localhost:11434"}
+EMBEDDING_MODEL=${OLLAMA_EMBEDDING_MODEL:-"nomic-embed-text"}
+CHAT_MODEL=${OLLAMA_CHAT_MODEL:-"llama3.1:8b"}
+
+echo "🚀 Setting up Ollama models for Prescient gem..."
+echo "Ollama URL: $OLLAMA_URL"
+
+# Function to check if Ollama is ready
+wait_for_ollama() {
+    echo "⏳ Waiting for Ollama to be ready..."
+    local max_attempts=30
+    local attempt=1
+    
+    while [ $attempt -le $max_attempts ]; do
+        if curl -s "$OLLAMA_URL/api/tags" > /dev/null 2>&1; then
+            echo "✅ Ollama is ready!"
+            return 0
+        fi
+        
+        echo "Attempt $attempt/$max_attempts - Ollama not ready yet..."
+        sleep 2
+        ((attempt++))
+    done
+    
+    echo "❌ Ollama failed to start within expected time"
+    exit 1
+}
+
+# Function to pull a model
+pull_model() {
+    local model_name=$1
+    echo "📦 Pulling model: $model_name"
+    
+    if curl -s -X POST "$OLLAMA_URL/api/pull" \
+        -H "Content-Type: application/json" \
+        -d "{\"name\": \"$model_name\"}" | grep -q "success"; then
+        echo "✅ Successfully pulled $model_name"
+    else
+        echo "⚠️  Model pull initiated for $model_name (this may take a while)"
+        # Wait a bit and check if model appears in list
+        sleep 5
+    fi
+}
+
+# Function to list available models
+list_models() {
+    echo "📋 Available models:"
+    curl -s "$OLLAMA_URL/api/tags" | jq -r '.models[]?.name // empty' 2>/dev/null || echo "Unable to list models"
+}
+
+# Main execution
+main() {
+    wait_for_ollama
+    
+    echo "🔧 Current models:"
+    list_models
+    
+    echo "📥 Pulling required models..."
+    pull_model "$EMBEDDING_MODEL"
+    pull_model "$CHAT_MODEL"
+    
+    echo "✨ Model setup complete!"
+    echo "📋 Final model list:"
+    list_models
+    
+    echo ""
+    echo "🎉 Ollama is ready for use with Prescient gem!"
+    echo "💡 You can now run the examples with:"
+    echo "   OLLAMA_URL=$OLLAMA_URL ruby examples/custom_contexts.rb"
+}
+
+main "$@"

metadata

@@ -1,38 +1,242 @@
 --- !ruby/object:Gem::Specification
 name: prescient
 version: !ruby/object:Gem::Version
-  version: 0.0.0
+  version: 0.1.0
 platform: ruby
 authors:
 - Ken C. Demanawa
 bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies: []
-description: Unified interface for AI providers including Ollama (local), Anthropic
-  Claude, OpenAI GPT, and HuggingFace models. Built for prescient applications that
-  need AI predictions with provider switching, error handling, and fallback mechanisms.
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.22.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.22.0
+- !ruby/object:Gem::Dependency
+  name: pg
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.20'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.20'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+- !ruby/object:Gem::Dependency
+  name: rubocop-minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.35'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.35'
+- !ruby/object:Gem::Dependency
+  name: rubocop-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.19'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.19'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: irb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Prescient provides a unified interface for AI providers including local
+  Ollama, Anthropic Claude, OpenAI GPT, and HuggingFace models. Built for AI applications
+  with error handling, health monitoring, and provider switching.
 email:
 - kenneth.c.demanawa@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".vscode/settings.json"
+- ".env.example"
+- ".rubocop.yml"
 - CODE_OF_CONDUCT.md
+- Dockerfile.example
 - LICENSE.txt
 - README.md
 - Rakefile
+- VECTOR_SEARCH_GUIDE.md
+- db/init/01_enable_pgvector.sql
+- db/init/02_create_schema.sql
+- db/init/03_create_indexes.sql
+- db/init/04_insert_sample_data.sql
+- db/migrate/001_create_prescient_tables.rb
+- docker-compose.yml
+- examples/basic_usage.rb
+- examples/custom_contexts.rb
+- examples/custom_prompts.rb
+- examples/vector_search.rb
 - lib/prescient.rb
+- lib/prescient/base.rb
+- lib/prescient/client.rb
+- lib/prescient/provider/anthropic.rb
+- lib/prescient/provider/huggingface.rb
+- lib/prescient/provider/ollama.rb
+- lib/prescient/provider/openai.rb
 - lib/prescient/version.rb
+- prescient.gemspec
+- scripts/setup-ollama-models.sh
 - sig/prescient.rbs
-homepage: https://github.com/kanutocd/prescient
+homepage: https://github.com/yourcompany/prescient
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://github.com/kanutocd/prescient
-  source_code_uri: https://github.com/kanutocd/prescient
+  homepage_uri: https://github.com/yourcompany/prescient
+  source_code_uri: https://github.com/yourcompany/prescient
+  changelog_uri: https://github.com/yourcompany/prescient/blob/main/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib
@@ -40,7 +244,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: 3.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -49,6 +253,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: Unified interface for AI providers including Ollama (local), Anthropic Claude,
-  OpenAI GPT, and HuggingFace models
+summary: Prescient AI provider abstraction for Ruby applications
 test_files: []

data/.vscode/settings.json

@@ -1 +0,0 @@
-{}