leva 0.1.6 → 0.1.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +3 -0
- data/app/models/leva/dataset_record.rb +2 -1
- data/app/models/leva/runner_result.rb +11 -9
- data/app/views/leva/workbench/_results_section.html.erb +1 -1
- data/db/migrate/20240912183556_add_runner_class_to_leva_runner_results.rb +5 -0
- data/lib/generators/leva/templates/eval.rb.erb +3 -3
- data/lib/generators/leva/templates/runner.rb.erb +25 -0
- data/lib/leva/version.rb +1 -1
- data/lib/leva.rb +23 -0
- metadata +3 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 0b12a341adbc24fa5c29fe3bf9961345fe02f66fb31089908a61ccf9d4061dff
|
4
|
+
data.tar.gz: 3e74533f1417a0f88aeab8f7942af4df7a6ad0eca6af89c1e29a1cd178cb3121
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: ad517366dd537adda1d937252e494215d36164f8461dbd818794d746bfb84838e7fa6889e29fa1cd873fdca7992f545832718acb0346ee2cd2dee80bb55ee9df
|
7
|
+
data.tar.gz: 5bf3f499fb42c99c898df934e7c188c85f2d10cb0ad77552b5d7a349552b9f614bc742be52648570ca13da9858e7144ce2dae39196d9a083b8aaac1f6c266b59
|
data/README.md
CHANGED
@@ -2,6 +2,9 @@
|
|
2
2
|
|
3
3
|
Leva is a Ruby on Rails framework for evaluating Language Models (LLMs) using ActiveRecord datasets on production models. It provides a flexible structure for creating experiments, managing datasets, and implementing various evaluation logic on production data with security in mind.
|
4
4
|
|
5
|
+

|
6
|
+

|
7
|
+
|
5
8
|
## Installation
|
6
9
|
|
7
10
|
Add this line to your application's Gemfile:
|
@@ -3,6 +3,7 @@
|
|
3
3
|
# Table name: leva_dataset_records
|
4
4
|
#
|
5
5
|
# id :integer not null, primary key
|
6
|
+
# actual_result :text
|
6
7
|
# recordable_type :string not null
|
7
8
|
# created_at :datetime not null
|
8
9
|
# updated_at :datetime not null
|
@@ -61,4 +62,4 @@ module Leva
|
|
61
62
|
end
|
62
63
|
end
|
63
64
|
end
|
64
|
-
end
|
65
|
+
end
|
@@ -5,6 +5,7 @@
|
|
5
5
|
# id :integer not null, primary key
|
6
6
|
# prediction :text
|
7
7
|
# prompt_version :integer
|
8
|
+
# runner_class :string
|
8
9
|
# created_at :datetime not null
|
9
10
|
# updated_at :datetime not null
|
10
11
|
# dataset_record_id :integer not null
|
@@ -32,23 +33,24 @@ module Leva
|
|
32
33
|
|
33
34
|
validates :prediction, presence: true
|
34
35
|
validates :prompt, presence: true
|
36
|
+
validates :runner_class, presence: true
|
35
37
|
|
36
38
|
delegate :ground_truth, to: :dataset_record
|
37
39
|
|
38
40
|
# @return [Array<String>] The parsed draft responses
|
39
41
|
def parsed_predictions
|
40
|
-
@parsed_predictions ||=
|
41
|
-
|
42
|
-
|
43
|
-
|
44
|
-
|
45
|
-
|
42
|
+
@parsed_predictions ||= runner&.parsed_predictions(self) || []
|
43
|
+
end
|
44
|
+
|
45
|
+
# @return [String] The ground truth for this runner result
|
46
|
+
def ground_truth
|
47
|
+
@ground_truth ||= runner&.ground_truth(self)
|
46
48
|
end
|
47
49
|
|
48
50
|
private
|
49
51
|
|
50
|
-
def
|
51
|
-
|
52
|
+
def runner
|
53
|
+
@runner ||= runner_class&.constantize&.new
|
52
54
|
end
|
53
55
|
end
|
54
|
-
end
|
56
|
+
end
|
@@ -42,7 +42,7 @@
|
|
42
42
|
<% if @dataset_record && (runner_result = @dataset_record.runner_results.last) %>
|
43
43
|
<div class="mb-3">
|
44
44
|
<h4 class="text-xs font-semibold text-indigo-200 mb-1">Ground Truth:</h4>
|
45
|
-
<pre class="text-sm text-gray-300 whitespace-pre-wrap bg-gray-700 p-2 rounded"><%=
|
45
|
+
<pre class="text-sm text-gray-300 whitespace-pre-wrap bg-gray-700 p-2 rounded"><%= runner_result.ground_truth %></pre>
|
46
46
|
</div>
|
47
47
|
<div>
|
48
48
|
<h4 class="text-xs font-semibold text-indigo-200 mb-1">Raw Prediction:</h4>
|
@@ -1,14 +1,14 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
2
|
|
3
3
|
class <%= class_name %>Eval < Leva::BaseEval
|
4
|
-
# @param
|
4
|
+
# @param runner_result [Leva::RunnerResult] The runner result to evaluate
|
5
5
|
# @param recordable [YourRecordClass] The recordable object to evaluate
|
6
6
|
# @return [Float] The score of the evaluation
|
7
|
-
def evaluate(
|
7
|
+
def evaluate(runner_result, recordable)
|
8
8
|
# Implement your evaluation logic here
|
9
9
|
# You can access the ground truth using recordable.ground_truth
|
10
10
|
|
11
11
|
# Example implementation:
|
12
|
-
|
12
|
+
runner_result.parsed_predictions.first == recordable.ground_truth ? 1.0 : 0.0
|
13
13
|
end
|
14
14
|
end
|
@@ -8,4 +8,29 @@ class <%= class_name %>Run < Leva::BaseRun
|
|
8
8
|
# This could involve calling an API, running a local model, etc.
|
9
9
|
# Return the result of the run to be used to evaluate the model
|
10
10
|
end
|
11
|
+
|
12
|
+
# Uncomment and modify this method to customize parsed predictions
|
13
|
+
# @param runner_result [Leva::RunnerResult] The runner result to parse
|
14
|
+
# @return [Array<String>] The parsed predictions
|
15
|
+
# def parsed_predictions(runner_result)
|
16
|
+
# # Example: Extract predictions from XML-like tags
|
17
|
+
# runner_result.prediction.scan(/<prediction>(.*?)<\/prediction>/).flatten
|
18
|
+
# end
|
19
|
+
|
20
|
+
# Uncomment and modify this method to customize ground truth extraction
|
21
|
+
# @param runner_result [Leva::RunnerResult] The runner result to get ground truth from
|
22
|
+
# @return [String] The ground truth for the runner result
|
23
|
+
# def ground_truth(runner_result)
|
24
|
+
# # Example: Extract ground truth from a specific field
|
25
|
+
# runner_result.dataset_record.recordable.custom_ground_truth_field
|
26
|
+
# end
|
27
|
+
|
28
|
+
# Uncomment and modify this method to customize regex extraction
|
29
|
+
# @param runner_result [Leva::RunnerResult] The runner result to extract regex from
|
30
|
+
# @return [Regexp, nil] The regex pattern to use for parsing predictions
|
31
|
+
# def extract_regex_pattern(runner_result)
|
32
|
+
# # Your custom regex extraction logic here
|
33
|
+
# # For example:
|
34
|
+
# # /\<result\>(.*?)\<\/result\>/
|
35
|
+
# end
|
11
36
|
end
|
data/lib/leva/version.rb
CHANGED
data/lib/leva.rb
CHANGED
@@ -72,8 +72,31 @@ module Leva
|
|
72
72
|
dataset_record: dataset_record,
|
73
73
|
prompt: prompt,
|
74
74
|
prediction: result,
|
75
|
+
runner_class: self.class.name
|
75
76
|
)
|
76
77
|
end
|
78
|
+
|
79
|
+
# @param runner_result [Leva::RunnerResult] The runner result to parse
|
80
|
+
# @return [Array<String>] The parsed predictions
|
81
|
+
def parsed_predictions(runner_result)
|
82
|
+
if extract_regex_pattern(runner_result)
|
83
|
+
runner_result.prediction.scan(extract_regex_pattern(runner_result)).map { |match| match.first&.strip }.compact
|
84
|
+
else
|
85
|
+
[runner_result.prediction]
|
86
|
+
end
|
87
|
+
end
|
88
|
+
|
89
|
+
# @param runner_result [Leva::RunnerResult] The runner result to extract regex from
|
90
|
+
# @return [Regexp, nil] The regex pattern to use for parsing predictions
|
91
|
+
def extract_regex_pattern(runner_result)
|
92
|
+
runner_result.dataset_record.recordable.extract_regex_pattern if runner_result.dataset_record.recordable.respond_to?(:extract_regex_pattern)
|
93
|
+
end
|
94
|
+
|
95
|
+
# @param runner_result [Leva::RunnerResult] The runner result to get ground truth from
|
96
|
+
# @return [String] The ground truth for the runner result
|
97
|
+
def ground_truth(runner_result)
|
98
|
+
runner_result.dataset_record.ground_truth
|
99
|
+
end
|
77
100
|
end
|
78
101
|
|
79
102
|
# Base class for all evaluation implementations in Leva.
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: leva
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.1.
|
4
|
+
version: 0.1.7
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Kieran Klaassen
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2024-09-
|
11
|
+
date: 2024-09-12 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: rails
|
@@ -111,6 +111,7 @@ files:
|
|
111
111
|
- db/migrate/20240821183153_add_runner_and_evaluator_to_leva_experiments.rb
|
112
112
|
- db/migrate/20240821191713_add_actual_result_to_leva_dataset_records.rb
|
113
113
|
- db/migrate/20240822143201_remove_actual_result_from_leva_runner_results.rb
|
114
|
+
- db/migrate/20240912183556_add_runner_class_to_leva_runner_results.rb
|
114
115
|
- lib/generators/leva/eval_generator.rb
|
115
116
|
- lib/generators/leva/runner_generator.rb
|
116
117
|
- lib/generators/leva/templates/eval.rb.erb
|