Module: Prescient

Defined in:
lib/prescient.rb,
lib/prescient/client.rb,
lib/prescient/errors.rb,
lib/prescient/version.rb

Overview

Main Prescient module for AI provider abstraction

Prescient provides a unified interface for working with multiple AI providers including Ollama, OpenAI, Anthropic, and Hugging Face. It supports both embedding generation and text completion with configurable context handling.

Examples:

Basic usage

Prescient.configure do |config|
  config.add_provider(:openai, Prescient::Provider::OpenAI,
                      api_key: 'your-api-key')
end

client = Prescient.client(:openai)
response = client.generate_response("Hello, world!")

Embedding generation

embedding = client.generate_embedding("Some text to embed")
puts embedding.length # => 1536 (for OpenAI text-embedding-3-small)

Defined Under Namespace

Modules: Pgvector, Provider Classes: AuthenticationError, Base, Client, Configuration, ConnectionError, Error, InvalidResponseError, InvalidVectorError, ModelNotAvailableError, ProviderError, RateLimitError

Constant Summary collapse

VERSION =

Current Prescient gem version.

'0.3.0'

Class Method Summary collapse

Class Method Details

.client(provider_name = nil, enable_fallback: true) ⇒ Client

Convenience methods for quick access

Parameters:

  • provider_name (Symbol, nil) (defaults to: nil) —

    Provider to use, or the configured default

  • enable_fallback (Boolean) (defaults to: true) —

    Whether provider fallback is enabled

Returns:

  • (Client) —

    A configured client instance



212
213
214
 
# File 'lib/prescient/client.rb', line 212

def self.client(provider_name = nil, enable_fallback: true)
  Client.new(provider_name, enable_fallback: enable_fallback)
end

.configuration ⇒ Configuration

Get the current configuration instance

Returns:



52
53
54
 
# File 'lib/prescient.rb', line 52

def self.configuration
  @_configuration ||= Configuration.new
end

.configure {|config| ... } ⇒ void

This method returns an undefined value.

Configure Prescient with custom settings and providers

Examples:

Configure with custom provider

Prescient.configure do |config|
  config.default_provider = :openai
  config.timeout = 60
  config.add_provider(:openai, Prescient::Provider::OpenAI,
                      api_key: 'your-key')
end

Yields:

  • (config) —

    Configuration block

Yield Parameters:



45
46
47
 
# File 'lib/prescient.rb', line 45

def self.configure
  yield(configuration)
end

.generate_embedding(text, provider: nil, enable_fallback: true, **options) ⇒ Array<Float>

Generate an embedding through a configured provider.

Parameters:

  • text (String) —

    Text to embed

  • provider (Symbol, nil) (defaults to: nil) —

    Provider to use

  • enable_fallback (Boolean) (defaults to: true) —

    Whether provider fallback is enabled

Returns:

  • (Array<Float>) —

    Embedding vector



222
223
224
 
# File 'lib/prescient/client.rb', line 222

def self.generate_embedding(text, provider: nil, enable_fallback: true, **options)
  client(provider, enable_fallback: enable_fallback).generate_embedding(text, **options)
end

.generate_response(prompt, context_items = [], provider: nil, enable_fallback: true, **options) ⇒ Hash

Generate a response through a configured provider.

Parameters:

  • prompt (String) —

    Prompt to send

  • context_items (Array<Hash, String>) (defaults to: []) —

    Optional context items

  • provider (Symbol, nil) (defaults to: nil) —

    Provider to use

  • enable_fallback (Boolean) (defaults to: true) —

    Whether provider fallback is enabled

Returns:

  • (Hash) —

    Normalized provider response with :response, :model, :provider and optional metadata



234
235
236
 
# File 'lib/prescient/client.rb', line 234

def self.generate_response(prompt, context_items = [], provider: nil, enable_fallback: true, **options)
  client(provider, enable_fallback: enable_fallback).generate_response(prompt, context_items, **options)
end

.health_check(provider: nil) ⇒ Hash

Return the health status of a configured provider.

Parameters:

  • provider (Symbol, nil) (defaults to: nil) —

    Provider to check

Returns:

  • (Hash) —

    Provider health information



242
243
244
 
# File 'lib/prescient/client.rb', line 242

def self.health_check(provider: nil)
  client(provider, enable_fallback: false).health_check
end

.reset_configuration! ⇒ Configuration

Reset configuration to defaults

Returns:



59
60
61
 
# File 'lib/prescient.rb', line 59

def self.reset_configuration!
  @_configuration = Configuration.new
end