judgeval 0.0.37__py3-none-any.whl → 0.0.38__py3-none-any.whl

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.
@@ -1,35 +1,34 @@
1
1
  judgeval/__init__.py,sha256=x9HWt4waJwJMAqTuJSg2MezF9Zg-macEjeU-ajbly-8,330
2
2
  judgeval/clients.py,sha256=6VQmEqmfCngUdS2MuPBIpHvtDFqOENm8-_BmMvjLyRQ,944
3
- judgeval/constants.py,sha256=KDHkZbzk-nr9uP-jsWUwpfaQSf4YkVfbO1o8w93-GME,5707
4
- judgeval/evaluation_run.py,sha256=MnlDSCXXi1vhTNTYC1XgPAl2BVG_ivNeFzIyfaw4Dho,6761
5
- judgeval/judgment_client.py,sha256=SiqazgyKkGsCVZ7J6XeL3Fvc51Oz7TM7yBgSfguJ0wQ,23625
3
+ judgeval/constants.py,sha256=qemyUNf5G5-W6YQ9tNkxbFa7L7XR6cDtWCVFKRwT3TM,5519
4
+ judgeval/evaluation_run.py,sha256=V9xMyiJ7e9lqHRblaeeMh6oyx1MEtGwfSxYtbi-EeXY,6746
5
+ judgeval/judgment_client.py,sha256=ozNMDeM3lNnaNq4zY40x3z1TwHYL1e25BlxGnSYO0yw,23275
6
6
  judgeval/rules.py,sha256=jkh1cXXcUf8oRY7xJUZfcQBYWn_rjUW4GvrhRt15PeU,20265
7
- judgeval/run_evaluation.py,sha256=66ppcGpCc08WrK46gWMJjktGzAg5alAWzRb9ncv9DTM,34555
7
+ judgeval/run_evaluation.py,sha256=-7oiebkggP7lf6nVRxqDKE3QkuPSA0sAVkZl_n2nZtI,32437
8
8
  judgeval/version_check.py,sha256=bvJEidB7rAeXozoUbN9Yb97QOR_s2hgvpvj74jJ5HlY,943
9
9
  judgeval/common/__init__.py,sha256=7d24BRxtncpMj3AAJCj8RS7TqgjXmW777HVZH6-3sBs,289
10
10
  judgeval/common/exceptions.py,sha256=U-TxHLn7oVMezsMuoYouNDb2XuS8RCggfntYf5_6u4E,565
11
11
  judgeval/common/logger.py,sha256=KO75wWXCxhUHUMvLaTU31ZzOk6tkZBa7heQ7y0f-zFE,6062
12
12
  judgeval/common/s3_storage.py,sha256=W8wq9S7qJZdqdBR4sk3aEZ4K3-pz40DOoolOJrWs9Vo,3768
13
- judgeval/common/tracer.py,sha256=5Pt49vSVK2zxh6p9nMW87Ju1eN3-M_mziSF_mDucXkA,87211
14
- judgeval/common/utils.py,sha256=oYjUgW8eL1qkzBe_tOz1WbCB6LbHWYvZN38XyXof8Eo,34086
15
- judgeval/data/__init__.py,sha256=-i7cuSBHrSTMf3UiIbFXwp56y15QJ7pmQeQK1yprhqM,561
13
+ judgeval/common/tracer.py,sha256=EkWkg2AsS5FIj2ffh912qZZ9ew5h3hu2rynPBDsMszw,80463
14
+ judgeval/common/utils.py,sha256=w1SjpDtB1DTJapFSAvLzr_a3gGI45iacEoxIUnQXx4Q,34087
15
+ judgeval/data/__init__.py,sha256=Q4WiIva20U_NgxGr-MU-9FWN_eFzUZBVgCsBmoo7IM8,501
16
16
  judgeval/data/custom_example.py,sha256=QRBqiRiZS8UgVeTRHY0r1Jzm6yAYsyg6zmHxQGxdiQs,739
17
- judgeval/data/example.py,sha256=EVniiTpaut2wlTS1u3MxB983odCRLSa9RJ74iAsR0wg,6929
18
- judgeval/data/result.py,sha256=Gb9tiSDsk1amXgh0cFG6JmlW_BMKxS2kuTwNA0rrHjA,3184
17
+ judgeval/data/example.py,sha256=MD0rA9oNI4cyaRgz7I7EOKv0gD2dp22Q_5z-NWdFHhE,6891
18
+ judgeval/data/result.py,sha256=KfU9lhAKG_Xo2eGDm2uKVVRZpf177IDASg1cIwedJwE,3184
19
19
  judgeval/data/scorer_data.py,sha256=JVlaTx1EP2jw2gh3Vgx1CSEsvIFABAN26IquKyxwiJQ,3273
20
- judgeval/data/sequence.py,sha256=vat_N0Acr64yfu97AfsaVPNrv2LqBiWCuYIoQWuxYwo,2074
21
- judgeval/data/sequence_run.py,sha256=XPa-MvwRK6ABKQtpMdmGHnoyL1KrgzQUjqItpLDc8U0,2213
22
- judgeval/data/trace.py,sha256=aRNwtJGebsm5MerVlZ3HKzviNAMpzydyUs88rs-BZ5Q,4899
20
+ judgeval/data/trace.py,sha256=IjL06YNElxTuJC0HrPUh69rtXkfkSpzDoZdNiXFUvwY,5043
21
+ judgeval/data/trace_run.py,sha256=G_OsHNK_nZzJKhtdiyWp7GFyyns5AOJZ956GM_4jXM0,2192
23
22
  judgeval/data/datasets/__init__.py,sha256=IdNKhQv9yYZ_op0rdBacrFaFVmiiYQ3JTzXzxOTsEVQ,176
24
- judgeval/data/datasets/dataset.py,sha256=1o-SMG96yYkSCxqUTItKKfeFFLhQXrE2cKPYEvlNeGw,13044
25
- judgeval/data/datasets/eval_dataset_client.py,sha256=uirHpkpLOfygXIz0xKAGTPx1qjbBTzdLFQK6yyoZduU,17544
26
- judgeval/integrations/langgraph.py,sha256=nQ6KAi9giirnWmD35i4CfoFYKzajh5ElvKh4t6Yasgs,122617
23
+ judgeval/data/datasets/dataset.py,sha256=oU9hvZTifK2x8em3FhL3oIqgHOByfJWH6C_9rIKnL5g,12773
24
+ judgeval/data/datasets/eval_dataset_client.py,sha256=3RBfkaMrkudjnmY_qFwY4I-2mOPE3XK4WxkfSweLB-Q,15016
25
+ judgeval/integrations/langgraph.py,sha256=L9zPPWVLGL2HWuwHPqM5Kic4S7EfQ_Y1Y3YKBJNfGCA,23004
27
26
  judgeval/judges/__init__.py,sha256=6X7VSwrwsdxGBNxCyapVRWGghhKOy3MVxFNMQ62kCXM,308
28
27
  judgeval/judges/base_judge.py,sha256=ch_S7uBB7lyv44Lf1d7mIGFpveOO58zOkkpImKgd9_4,994
29
- judgeval/judges/litellm_judge.py,sha256=EIL58Teptv8DzZUO3yP2RDQCDq-aoBB6HPZzPdK6KTg,2424
30
- judgeval/judges/mixture_of_judges.py,sha256=IJoi4Twk8ze1CJWVEp69k6TSqTCTGrmVYQ0qdffer60,15549
28
+ judgeval/judges/litellm_judge.py,sha256=DhB6px9ELZL3gbMb2w4FkBliuTlaCVIcjE8v149G6NM,2425
29
+ judgeval/judges/mixture_of_judges.py,sha256=D97h8L-6saPwwppVwitrIdlMAjizzxGWeVOfNyVnXZA,15550
31
30
  judgeval/judges/together_judge.py,sha256=l00hhPerAZXg3oYBd8cyMtWsOTNt_0FIqoxhKJKQe3k,2302
32
- judgeval/judges/utils.py,sha256=9lvUxziGV86ISvVFxYBWc09TWFyAQgUTyPf_a9mD5Rs,2686
31
+ judgeval/judges/utils.py,sha256=vL-15_udU94JHUAiyrAvHAKMj6Fqypg01ek4YH5zVCM,2687
33
32
  judgeval/scorers/__init__.py,sha256=-4GLkYiLKI_BxpoIfgadCFEUfqJcBWZLAtfrInjZT0Q,1282
34
33
  judgeval/scorers/api_scorer.py,sha256=NQ_CrrUPhSUk1k2Q8rKpCG_TU2FT32sFEqvb-Yi54B0,2688
35
34
  judgeval/scorers/exceptions.py,sha256=eGW5CuJgZ5YJBFrE4FHDSF651PO1dKAZ379mJ8gOsfo,178
@@ -53,14 +52,14 @@ judgeval/scorers/judgeval_scorers/api_scorers/hallucination.py,sha256=k5gDOki-8K
53
52
  judgeval/scorers/judgeval_scorers/api_scorers/instruction_adherence.py,sha256=XnSGEkQfwVqaqnHEGMCsxNiHVzrsrej48uDbLoWc8CQ,678
54
53
  judgeval/scorers/judgeval_scorers/api_scorers/json_correctness.py,sha256=mMKEuR87_yanEuZJ5YSGFMHDD_oLVZ6-rQuciFaDOMA,1095
55
54
  judgeval/scorers/judgeval_scorers/api_scorers/summarization.py,sha256=QmWB8bVbDYHY5FcF0rYZE_3c2XXgMLRmR6aXJWfdMC4,655
56
- judgeval/scorers/judgeval_scorers/api_scorers/tool_order.py,sha256=yBd5KU4wBTHFMi1B6D8hRdPOYYQl4uD7Z-xCW4yk5-E,427
55
+ judgeval/scorers/judgeval_scorers/api_scorers/tool_order.py,sha256=urm8LgkeZA7e-ePWo6AToKGheQYSp6MOpKon5NF5EJw,570
57
56
  judgeval/scorers/judgeval_scorers/classifiers/__init__.py,sha256=Qt81W5ZCwMvBAne0LfQDb8xvg5iOG1vEYP7WizgwAZo,67
58
57
  judgeval/scorers/judgeval_scorers/classifiers/text2sql/__init__.py,sha256=8iTzMvou1Dr8pybul6lZHKjc9Ye2-0_racRGYkhEdTY,74
59
58
  judgeval/scorers/judgeval_scorers/classifiers/text2sql/text2sql_scorer.py,sha256=ly72Z7s_c8NID6-nQnuW8qEGEW2MqdvpJ-5WfXzbAQg,2579
60
59
  judgeval/tracer/__init__.py,sha256=wy3DYpH8U_z0GO_K_gOSkK0tTTD-u5eLDo0T5xIBoAc,147
61
60
  judgeval/utils/alerts.py,sha256=O19Xj7DA0YVjl8PWiuH4zfdZeu3yiLVvHfY8ah2wG0g,2759
62
61
  judgeval/utils/data_utils.py,sha256=pB4GBWi8XoM2zSR2NlLXH5kqcQ029BVhDxaVKkdmiBY,1860
63
- judgeval-0.0.37.dist-info/METADATA,sha256=0XKc4BJUpG8qnB3a9afhh8l7H_C19ritSJv95ogifXw,7742
64
- judgeval-0.0.37.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
65
- judgeval-0.0.37.dist-info/licenses/LICENSE.md,sha256=tKmCg7k5QOmxPK19XMfzim04QiQJPmgIm0pAn55IJwk,11352
66
- judgeval-0.0.37.dist-info/RECORD,,
62
+ judgeval-0.0.38.dist-info/METADATA,sha256=jlCQMfdz2Ni9nRi9cOu5svHnLqIinll2odC37dqkE3U,11860
63
+ judgeval-0.0.38.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
64
+ judgeval-0.0.38.dist-info/licenses/LICENSE.md,sha256=tKmCg7k5QOmxPK19XMfzim04QiQJPmgIm0pAn55IJwk,11352
65
+ judgeval-0.0.38.dist-info/RECORD,,
judgeval/data/sequence.py DELETED
@@ -1,50 +0,0 @@
1
- from pydantic import BaseModel, Field, field_validator, model_validator
2
- from typing import List, Optional, Union, Any, Dict
3
- from judgeval.data.example import Example
4
- from judgeval.scorers import JudgevalScorer, APIJudgmentScorer
5
- from uuid import uuid4
6
- from datetime import datetime, timezone
7
-
8
- class Sequence(BaseModel):
9
- """
10
- A sequence is a list of either Examples or nested Sequence objects.
11
- """
12
- sequence_id: str = Field(default_factory=lambda: str(uuid4()))
13
- name: Optional[str] = "Sequence"
14
- created_at: str = Field(default_factory=lambda: datetime.now(timezone.utc).strftime("%Y%m%d_%H%M%S"))
15
- items: List[Union["Sequence", Example]] = []
16
- scorers: Optional[Any] = None
17
- parent_sequence_id: Optional[str] = None
18
- sequence_order: Optional[int] = 0
19
- root_sequence_id: Optional[str] = None
20
- inputs: Optional[Dict[str, Any]] = None
21
- output: Optional[Any] = None
22
- expected_tools: Optional[List[Dict[str, Any]]] = None
23
-
24
- @field_validator("scorers")
25
- def validate_scorer(cls, v):
26
- for scorer in v or []:
27
- if not isinstance(scorer, APIJudgmentScorer) and not isinstance(scorer, JudgevalScorer):
28
- raise ValueError(f"Invalid scorer type: {type(scorer)}")
29
- return v
30
-
31
- @model_validator(mode="after")
32
- def populate_sequence_metadata(self) -> "Sequence":
33
- """Recursively set parent_sequence_id, root_sequence_id, and sequence_order."""
34
- # If root_sequence_id isn't already set, assign it to self
35
- if self.root_sequence_id is None:
36
- self.root_sequence_id = self.sequence_id
37
-
38
- for idx, item in enumerate(self.items):
39
- item.sequence_order = idx
40
- if isinstance(item, Sequence):
41
- item.parent_sequence_id = self.sequence_id
42
- item.root_sequence_id = self.root_sequence_id
43
- item.populate_sequence_metadata()
44
- return self
45
-
46
- class Config:
47
- arbitrary_types_allowed = True
48
-
49
- # Update forward references so that "Sequence" inside items is resolved.
50
- Sequence.model_rebuild()
@@ -1,214 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: judgeval
3
- Version: 0.0.37
4
- Summary: Judgeval Package
5
- Project-URL: Homepage, https://github.com/JudgmentLabs/judgeval
6
- Project-URL: Issues, https://github.com/JudgmentLabs/judgeval/issues
7
- Author-email: Andrew Li <andrew@judgmentlabs.ai>, Alex Shan <alex@judgmentlabs.ai>, Joseph Camyre <joseph@judgmentlabs.ai>
8
- License-Expression: Apache-2.0
9
- License-File: LICENSE.md
10
- Classifier: Operating System :: OS Independent
11
- Classifier: Programming Language :: Python :: 3
12
- Requires-Python: >=3.11
13
- Requires-Dist: anthropic
14
- Requires-Dist: boto3
15
- Requires-Dist: google-genai
16
- Requires-Dist: langchain-anthropic
17
- Requires-Dist: langchain-core
18
- Requires-Dist: langchain-huggingface
19
- Requires-Dist: langchain-openai
20
- Requires-Dist: litellm==1.38.12
21
- Requires-Dist: nest-asyncio
22
- Requires-Dist: openai
23
- Requires-Dist: pandas
24
- Requires-Dist: python-dotenv==1.0.1
25
- Requires-Dist: requests
26
- Requires-Dist: together
27
- Description-Content-Type: text/markdown
28
-
29
- <div align="center">
30
-
31
- <img src="assets/logo-light.svg#gh-light-mode-only" alt="Judgment Logo" width="400" />
32
- <img src="assets/logo-dark.svg#gh-dark-mode-only" alt="Judgment Logo" width="400" />
33
-
34
- **Build monitoring & evaluation pipelines for complex agents**
35
-
36
- [Website](https://www.judgmentlabs.ai/) • [Twitter/X](https://x.com/JudgmentLabs) • [LinkedIn](https://www.linkedin.com/company/judgmentlabs) • [Documentation](https://judgment.mintlify.app/getting_started) • [Demos](https://www.youtube.com/@AlexShan-j3o)
37
-
38
- </div>
39
-
40
- ## 🚀 What is Judgeval?
41
-
42
- Judgeval is an open-source tool for testing, monitoring, and optimizing AI agents. Judgeval is created and maintained by [Judgment Labs](https://judgmentlabs.ai/).
43
-
44
-
45
- **🔍 Tracing**
46
- * Automatic agent tracing for common agent frameworks and SDKs (LangGraph, OpenAI, Anthropic, etc.)
47
- * Track input/output, latency, cost, token usage at every step
48
- * Function tracing with `@judgment.observe` decorator
49
-
50
- **🧪 Evals**
51
- * Plug-and-measure 15+ metrics, including:
52
- * Tool call accuracy
53
- * Hallucinations
54
- * Instruction adherence
55
- * Retrieval context recall
56
-
57
- Our metric implementations are research-backed by Stanford and Berkeley AI labs. Check out our [research](https://judgmentlabs.ai/research)!
58
- * Build custom evaluators that seamlessly connect with our infrastructure!
59
- * Use our evals for:
60
- * ⚠️ Unit-testing your agent
61
- * 🔬 Experimentally testing new prompts and models
62
- * 🛡️ Online evaluations to guardrail your agent's actions and responses
63
-
64
- **📊 Datasets**
65
- * Export trace data to datasets hosted on Judgment's Platform and export to JSON, Parquet, S3, etc.
66
- * Run evals on datasets as unit-tests or to A/B test agent configs
67
-
68
- **💡 Insights**
69
- * Error clustering groups agent failures to uncover failure patterns and speed up root cause analysis
70
- * Trace agent failures to their exact source. Judgment's Osiris agent localizes errors to specific agent components, enabling precise, targeted fixes.
71
-
72
-
73
- ## 🛠️ Installation
74
-
75
- Get started with Judgeval by installing our SDK using pip:
76
-
77
- ```bash
78
- pip install judgeval
79
- ```
80
-
81
- Ensure you have your `JUDGMENT_API_KEY` environment variable set to connect to the [Judgment platform](https://app.judgmentlabs.ai/). If you don't have a key, create an account on the platform!
82
-
83
- ## 🏁 Get Started
84
-
85
- Here's how you can quickly start using Judgeval:
86
-
87
- ### 🛰️ Tracing
88
-
89
- Track your agent execution with full observability with just a few lines of code.
90
- Create a file named `traces.py` with the following code:
91
-
92
- ```python
93
- from judgeval.common.tracer import Tracer, wrap
94
- from openai import OpenAI
95
-
96
- client = wrap(OpenAI())
97
- judgment = Tracer(project_name="my_project")
98
-
99
- @judgment.observe(span_type="tool")
100
- def my_tool():
101
- return "What's the capital of the U.S.?"
102
-
103
- @judgment.observe(span_type="function")
104
- def main():
105
- task_input = my_tool()
106
- res = client.chat.completions.create(
107
- model="gpt-4.1",
108
- messages=[{"role": "user", "content": f"{task_input}"}]
109
- )
110
- return res.choices[0].message.content
111
-
112
- main()
113
- ```
114
-
115
- [Click here](https://judgment.mintlify.app/getting_started#create-your-first-trace) for a more detailed explanation.
116
-
117
- ### 📝 Offline Evaluations
118
-
119
- You can evaluate your agent's execution to measure quality metrics such as hallucination.
120
- Create a file named `evaluate.py` with the following code:
121
-
122
- ```python evaluate.py
123
- from judgeval import JudgmentClient
124
- from judgeval.data import Example
125
- from judgeval.scorers import FaithfulnessScorer
126
-
127
- client = JudgmentClient()
128
-
129
- example = Example(
130
- input="What if these shoes don't fit?",
131
- actual_output="We offer a 30-day full refund at no extra cost.",
132
- retrieval_context=["All customers are eligible for a 30 day full refund at no extra cost."],
133
- )
134
-
135
- scorer = FaithfulnessScorer(threshold=0.5)
136
- results = client.run_evaluation(
137
- examples=[example],
138
- scorers=[scorer],
139
- model="gpt-4.1",
140
- )
141
- print(results)
142
- ```
143
-
144
- [Click here](https://judgment.mintlify.app/getting_started#create-your-first-experiment) for a more detailed explanation.
145
-
146
- ### 📡 Online Evaluations
147
-
148
- Apply performance monitoring to measure the quality of your systems in production, not just on traces.
149
-
150
- Using the same `traces.py` file we created earlier, modify `main` function:
151
-
152
- ```python
153
- from judgeval.common.tracer import Tracer, wrap
154
- from judgeval.scorers import AnswerRelevancyScorer
155
- from openai import OpenAI
156
-
157
- client = wrap(OpenAI())
158
- judgment = Tracer(project_name="my_project")
159
-
160
- @judgment.observe(span_type="tool")
161
- def my_tool():
162
- return "Hello world!"
163
-
164
- @judgment.observe(span_type="function")
165
- def main():
166
- task_input = my_tool()
167
- res = client.chat.completions.create(
168
- model="gpt-4.1",
169
- messages=[{"role": "user", "content": f"{task_input}"}]
170
- ).choices[0].message.content
171
-
172
- judgment.get_current_trace().async_evaluate(
173
- scorers=[AnswerRelevancyScorer(threshold=0.5)],
174
- input=task_input,
175
- actual_output=res,
176
- model="gpt-4.1"
177
- )
178
- print("Online evaluation submitted.")
179
- return res
180
-
181
- main()
182
- ```
183
-
184
- [Click here](https://judgment.mintlify.app/getting_started#create-your-first-online-evaluation) for a more detailed explanation.
185
-
186
- ## 🏢 Self-Hosting
187
-
188
- Run Judgment on your own infrastructure: we provide comprehensive self-hosting capabilities that give you full control over the backend and data plane that Judgeval interfaces with.
189
-
190
- ### Key Features
191
- * Deploy Judgment on your own AWS account
192
- * Store data in your own Supabase instance
193
- * Access Judgment through your own custom domain
194
-
195
- ### Getting Started
196
- 1. Check out our [self-hosting documentation](https://judgment.mintlify.app/self_hosting/get_started) for detailed setup instructions, along with how your self-hosted instance can be accessed
197
- 2. Use the [Judgment CLI](https://github.com/JudgmentLabs/judgment-cli) to deploy your self-hosted environment
198
- 3. After your self-hosted instance is setup, make sure the `JUDGMENT_API_URL` environmental variable is set to your self-hosted backend endpoint
199
-
200
- ## ⭐ Star Us on GitHub
201
-
202
- If you find Judgeval useful, please consider giving us a star on GitHub! Your support helps us grow our community and continue improving the product.
203
-
204
- ## 🤝 Contributing
205
-
206
- There are many ways to contribute to Judgeval:
207
-
208
- - Submit [bug reports](https://github.com/JudgmentLabs/judgeval/issues) and [feature requests](https://github.com/JudgmentLabs/judgeval/issues)
209
- - Review the documentation and submit [Pull Requests](https://github.com/JudgmentLabs/judgeval/pulls) to improve it
210
- - Speaking or writing about Judgment and letting us know!
211
-
212
- ## Documentation and Demos
213
-
214
- For more detailed documentation, please check out our [developer docs](https://judgment.mintlify.app/getting_started) and some of our [demo videos](https://www.youtube.com/@AlexShan-j3o) for reference!