judgeval 0.0.39__py3-none-any.whl → 0.0.40__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,25 +1,25 @@
1
1
  judgeval/__init__.py,sha256=x9HWt4waJwJMAqTuJSg2MezF9Zg-macEjeU-ajbly-8,330
2
- judgeval/clients.py,sha256=6VQmEqmfCngUdS2MuPBIpHvtDFqOENm8-_BmMvjLyRQ,944
3
- judgeval/constants.py,sha256=aDEy51CUbzp_CWARFmw3Fie5fZ-2pkaYPc_gUEbvT4Y,5591
4
- judgeval/evaluation_run.py,sha256=V9xMyiJ7e9lqHRblaeeMh6oyx1MEtGwfSxYtbi-EeXY,6746
5
- judgeval/judgment_client.py,sha256=eQQ6J3iUPHfBu9v83-8F-yNMqf015b1NoGsbLOzy2s4,23375
2
+ judgeval/clients.py,sha256=EiTmvvWksTPyWIuMC9jz06SPY2vFzokIJUIGoScpisA,989
3
+ judgeval/constants.py,sha256=xuO-Und5c0-K3yTRn2fAkwyY2uTf8b7dGd39CPVqkSQ,5661
4
+ judgeval/evaluation_run.py,sha256=KNGtaGAwD18pDNOKF7PCMlLnQe9SpRLTs0XWFMrCiLc,6684
5
+ judgeval/judgment_client.py,sha256=TkYNCzuy5toIqvsgCSGO4WyKfUSgEM_gX2pbQqWCFJo,24481
6
6
  judgeval/rules.py,sha256=jkh1cXXcUf8oRY7xJUZfcQBYWn_rjUW4GvrhRt15PeU,20265
7
- judgeval/run_evaluation.py,sha256=bYNbMubqOOUNlsplY5Iw9IpUxuuqsJHIs-RweWC45E4,47474
7
+ judgeval/run_evaluation.py,sha256=Kg2iFrpVq-rGMfQokM5s_LJ4BSqGNxjQUxnxfaiTOZ4,49135
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=EkWkg2AsS5FIj2ffh912qZZ9ew5h3hu2rynPBDsMszw,80463
13
+ judgeval/common/tracer.py,sha256=0HwWwbvnT9Z686q9ppqUB54xR-GKqlBnkXf29c76eow,84425
14
14
  judgeval/common/utils.py,sha256=w1SjpDtB1DTJapFSAvLzr_a3gGI45iacEoxIUnQXx4Q,34087
15
- judgeval/data/__init__.py,sha256=Q4WiIva20U_NgxGr-MU-9FWN_eFzUZBVgCsBmoo7IM8,501
15
+ judgeval/data/__init__.py,sha256=GX_GloDtBB35mv3INWbSTP2r9cwCU2IeIYjzRT0SAd8,530
16
16
  judgeval/data/custom_example.py,sha256=QRBqiRiZS8UgVeTRHY0r1Jzm6yAYsyg6zmHxQGxdiQs,739
17
- judgeval/data/example.py,sha256=XptCg2dLMS46SfDYa4kLgq1zXnlDnhOmR15Ci_08p90,6882
17
+ judgeval/data/example.py,sha256=jcK78ff-TKNl9Qtxvbd1g61crpo-s4fWHaqyMIbQNq0,6877
18
18
  judgeval/data/result.py,sha256=KfU9lhAKG_Xo2eGDm2uKVVRZpf177IDASg1cIwedJwE,3184
19
19
  judgeval/data/scorer_data.py,sha256=JVlaTx1EP2jw2gh3Vgx1CSEsvIFABAN26IquKyxwiJQ,3273
20
- judgeval/data/tool.py,sha256=x6YsdTTfeIwSn5f1xIDU3j1xJgSCzho0FW1ojR-L0Ac,612
21
- judgeval/data/trace.py,sha256=euYIbwYsGqATWIeOZwBzNWS3hh3wefVzMJ7v5rHvG6c,5069
22
- judgeval/data/trace_run.py,sha256=G_OsHNK_nZzJKhtdiyWp7GFyyns5AOJZ956GM_4jXM0,2192
20
+ judgeval/data/tool.py,sha256=eEEvGDNNYWhcQiI6cjDv3rO1VoOJJS5LWGS76Gb_gtY,1813
21
+ judgeval/data/trace.py,sha256=ETZEb_MJfv4vWr2y_uZ7FfIua7GrV6jgSUVjjURAdlQ,4602
22
+ judgeval/data/trace_run.py,sha256=fiB5Z5il9U9XqvksdA2DbLNd96U_Wrz8K00RuFJBy38,2324
23
23
  judgeval/data/datasets/__init__.py,sha256=IdNKhQv9yYZ_op0rdBacrFaFVmiiYQ3JTzXzxOTsEVQ,176
24
24
  judgeval/data/datasets/dataset.py,sha256=oU9hvZTifK2x8em3FhL3oIqgHOByfJWH6C_9rIKnL5g,12773
25
25
  judgeval/data/datasets/eval_dataset_client.py,sha256=3RBfkaMrkudjnmY_qFwY4I-2mOPE3XK4WxkfSweLB-Q,15016
@@ -30,17 +30,18 @@ judgeval/judges/litellm_judge.py,sha256=DhB6px9ELZL3gbMb2w4FkBliuTlaCVIcjE8v149G
30
30
  judgeval/judges/mixture_of_judges.py,sha256=D97h8L-6saPwwppVwitrIdlMAjizzxGWeVOfNyVnXZA,15550
31
31
  judgeval/judges/together_judge.py,sha256=l00hhPerAZXg3oYBd8cyMtWsOTNt_0FIqoxhKJKQe3k,2302
32
32
  judgeval/judges/utils.py,sha256=vL-15_udU94JHUAiyrAvHAKMj6Fqypg01ek4YH5zVCM,2687
33
- judgeval/scorers/__init__.py,sha256=-4GLkYiLKI_BxpoIfgadCFEUfqJcBWZLAtfrInjZT0Q,1282
33
+ judgeval/scorers/__init__.py,sha256=VKPveyGCv5Rc0YtuT7iAxSv-M5EuikqAVeaGNnYMuWE,1340
34
34
  judgeval/scorers/api_scorer.py,sha256=NQ_CrrUPhSUk1k2Q8rKpCG_TU2FT32sFEqvb-Yi54B0,2688
35
35
  judgeval/scorers/exceptions.py,sha256=eGW5CuJgZ5YJBFrE4FHDSF651PO1dKAZ379mJ8gOsfo,178
36
- judgeval/scorers/judgeval_scorer.py,sha256=79-JJurqHP-qTaWNWInx4SjvQYwXc9lvfPPNgwsh2yA,6773
37
- judgeval/scorers/prompt_scorer.py,sha256=PaAs2qRolw1P3_I061Xvk9qzvF4O-JR8g_39RqXnHcM,17728
38
- judgeval/scorers/score.py,sha256=m9luk5ZLeUCual5CpI-9ZR9nqR3eC9wJLVT87SFPN6g,18747
36
+ judgeval/scorers/judgeval_scorer.py,sha256=id4s72vn4pWKbjZDnWKHGlc4kqyUkrFqdlX1SgyDj6c,7027
37
+ judgeval/scorers/prompt_scorer.py,sha256=9MGSG2OVvX2i2CUZmXg0i3rJHQKMe2dMBdMDcnjp8mg,11845
38
+ judgeval/scorers/score.py,sha256=h4eVlbItqG8R0nQgSgeyicYSIraZV9MvV-RRaFu46mg,18762
39
39
  judgeval/scorers/utils.py,sha256=iHQVTlIANbmCTXz9kTeSdOytgUZ_T74Re61ajqsk_WQ,6827
40
40
  judgeval/scorers/judgeval_scorers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
41
- judgeval/scorers/judgeval_scorers/api_scorers/__init__.py,sha256=QhHKpl6kNEXxuwriSEwQ5gIIxb7NeHZ1H_7SAZhQiQk,1872
41
+ judgeval/scorers/judgeval_scorers/api_scorers/__init__.py,sha256=knJr1fMqdisS2dt1caMyiMmVkP9QMZBTBTRgjoIRKdQ,2112
42
42
  judgeval/scorers/judgeval_scorers/api_scorers/answer_correctness.py,sha256=Fnd9CVIOZ73sWEWymsU5eBrrZqPFjMZ0BKpeW-PDyTg,711
43
43
  judgeval/scorers/judgeval_scorers/api_scorers/answer_relevancy.py,sha256=oETeN9K0HSIRdL2SDqn82Vskpwh5SlKnZvs5VDm2OBU,658
44
+ judgeval/scorers/judgeval_scorers/api_scorers/classifier_scorer.py,sha256=s5DKbvLgWN5kV00isu56A5U4R7w1ahlGVN1yxscqHHc,4515
44
45
  judgeval/scorers/judgeval_scorers/api_scorers/comparison.py,sha256=kuzf9OWvpY38yYSwlBgneLkUZwJNM4FQqvbS66keA90,1249
45
46
  judgeval/scorers/judgeval_scorers/api_scorers/contextual_precision.py,sha256=tpSuzFAaW8X9xqA0aLLKwh7qmBK0Pc_bJZMIe_q412U,770
46
47
  judgeval/scorers/judgeval_scorers/api_scorers/contextual_recall.py,sha256=pFVhk4pLtQ-FnNlbI-dFF-SIh69Jza7erHqiPkFWoBo,758
@@ -53,14 +54,15 @@ judgeval/scorers/judgeval_scorers/api_scorers/hallucination.py,sha256=k5gDOki-8K
53
54
  judgeval/scorers/judgeval_scorers/api_scorers/instruction_adherence.py,sha256=XnSGEkQfwVqaqnHEGMCsxNiHVzrsrej48uDbLoWc8CQ,678
54
55
  judgeval/scorers/judgeval_scorers/api_scorers/json_correctness.py,sha256=mMKEuR87_yanEuZJ5YSGFMHDD_oLVZ6-rQuciFaDOMA,1095
55
56
  judgeval/scorers/judgeval_scorers/api_scorers/summarization.py,sha256=QmWB8bVbDYHY5FcF0rYZE_3c2XXgMLRmR6aXJWfdMC4,655
57
+ judgeval/scorers/judgeval_scorers/api_scorers/tool_dependency.py,sha256=xHt4NsPCOyQkI5mUnN35D-vBLLFu6ZCMaiIVc4RTlj8,620
56
58
  judgeval/scorers/judgeval_scorers/api_scorers/tool_order.py,sha256=urm8LgkeZA7e-ePWo6AToKGheQYSp6MOpKon5NF5EJw,570
57
59
  judgeval/scorers/judgeval_scorers/classifiers/__init__.py,sha256=Qt81W5ZCwMvBAne0LfQDb8xvg5iOG1vEYP7WizgwAZo,67
58
60
  judgeval/scorers/judgeval_scorers/classifiers/text2sql/__init__.py,sha256=8iTzMvou1Dr8pybul6lZHKjc9Ye2-0_racRGYkhEdTY,74
59
- judgeval/scorers/judgeval_scorers/classifiers/text2sql/text2sql_scorer.py,sha256=ly72Z7s_c8NID6-nQnuW8qEGEW2MqdvpJ-5WfXzbAQg,2579
61
+ judgeval/scorers/judgeval_scorers/classifiers/text2sql/text2sql_scorer.py,sha256=O9xq2Cxcg16pFNZwHTb_MDJ5ehFab6oDiiNtC47AnY4,2584
60
62
  judgeval/tracer/__init__.py,sha256=wy3DYpH8U_z0GO_K_gOSkK0tTTD-u5eLDo0T5xIBoAc,147
61
63
  judgeval/utils/alerts.py,sha256=O19Xj7DA0YVjl8PWiuH4zfdZeu3yiLVvHfY8ah2wG0g,2759
62
64
  judgeval/utils/data_utils.py,sha256=pB4GBWi8XoM2zSR2NlLXH5kqcQ029BVhDxaVKkdmiBY,1860
63
- judgeval-0.0.39.dist-info/METADATA,sha256=Q4wTRKXRoTozgF96BJFFoGwOoy-vLnAGs0HOQ9PCZ_k,11860
64
- judgeval-0.0.39.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
65
- judgeval-0.0.39.dist-info/licenses/LICENSE.md,sha256=tKmCg7k5QOmxPK19XMfzim04QiQJPmgIm0pAn55IJwk,11352
66
- judgeval-0.0.39.dist-info/RECORD,,
65
+ judgeval-0.0.40.dist-info/METADATA,sha256=pAFVIDRiMlCOrbfQ0-epidECcUHl_fFuiLPgGnhDJYo,56712
66
+ judgeval-0.0.40.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
67
+ judgeval-0.0.40.dist-info/licenses/LICENSE.md,sha256=tKmCg7k5QOmxPK19XMfzim04QiQJPmgIm0pAn55IJwk,11352
68
+ judgeval-0.0.40.dist-info/RECORD,,
@@ -1,247 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: judgeval
3
- Version: 0.0.39
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
- <img src="assets/experiments_page.png" alt="Judgment Platform Experiments Page" width="800" />
37
-
38
- <br>
39
-
40
- ## [🌐 Landing Page](https://www.judgmentlabs.ai/) • [Twitter/X](https://x.com/JudgmentLabs) • [💼 LinkedIn](https://www.linkedin.com/company/judgmentlabs) • [📚 Docs](https://judgment.mintlify.app/getting_started) • [🚀 Demos](https://www.youtube.com/@AlexShan-j3o) • [🎮 Discord](https://discord.gg/taAufyhf)
41
- </div>
42
-
43
- ## Judgeval: open-source testing, monitoring, and optimization for AI agents
44
-
45
- Judgeval offers robust tooling for evaluating and tracing LLM agent systems. It is dev-friendly and open-source (licensed under Apache 2.0).
46
-
47
- Judgeval gets you started in five minutes, after which you'll be ready to use all of its features as your agent becomes more complex. Judgeval is natively connected to the [Judgment Platform](https://www.judgmentlabs.ai/) for free and you can export your data and self-host at any time.
48
-
49
- We support tracing agents built with LangGraph, OpenAI SDK, Anthropic, ... and allow custom eval integrations for any use case. Check out our quickstarts below or our [setup guide](https://judgment.mintlify.app/getting_started) to get started.
50
-
51
- Judgeval is created and maintained by [Judgment Labs](https://judgmentlabs.ai/).
52
-
53
- ## 📋 Table of Contents
54
- * [✨ Features](#-features)
55
- * [🔍 Tracing](#-tracing)
56
- * [🧪 Evals](#-evals)
57
- * [📡 Monitoring](#-monitoring)
58
- * [📊 Datasets](#-datasets)
59
- * [💡 Insights](#-insights)
60
- * [🛠️ Installation](#️-installation)
61
- * [🏁 Get Started](#-get-started)
62
- * [🏢 Self-Hosting](#-self-hosting)
63
- * [📚 Cookbooks](#-cookbooks)
64
- * [⭐ Star Us on GitHub](#-star-us-on-github)
65
- * [❤️ Contributors](#️-contributors)
66
-
67
- <!-- Created by https://github.com/ekalinin/github-markdown-toc -->
68
-
69
-
70
- ## ✨ Features
71
-
72
- | | |
73
- |:---|:---:|
74
- | <h3>🔍 Tracing</h3>Automatic agent tracing integrated with common frameworks (LangGraph, OpenAI, Anthropic): **tracking inputs/outputs, latency, and cost** at every step.<br><br>Online evals can be applied to traces to measure quality on production data in real-time.<br><br>Export trace data to the Judgment Platform or your own S3 buckets, {Parquet, JSON, YAML} files, or data warehouse.<br><br>**Useful for:**<br>• 🐛 Debugging agent runs <br>• 👤 Tracking user activity <br>• 🔬 Pinpointing performance bottlenecks| <p align="center"><img src="assets/trace_screenshot.png" alt="Tracing visualization" width="1200"/></p> |
75
- | <h3>🧪 Evals</h3>15+ research-backed metrics including tool call accuracy, hallucinations, instruction adherence, and retrieval context recall.<br><br>Build custom evaluators that connect with our metric-tracking infrastructure. <br><br>**Useful for:**<br>• ⚠️ Unit-testing <br>• 🔬 Experimental prompt testing<br>• 🛡️ Online guardrails <br><br> | <p align="center"><img src="assets/experiments_page.png" alt="Evaluation metrics" width="800"/></p> |
76
- | <h3>📡 Monitoring</h3>Real-time performance tracking of your agents in production environments. **Track all your metrics in one place.**<br><br>Set up **Slack/email alerts** for critical metrics and receive notifications when thresholds are exceeded.<br><br> **Useful for:** <br>•📉 Identifying degradation early <br>•📈 Visualizing performance trends across versions and time | <p align="center"><img src="assets/monitoring_screenshot.png" alt="Monitoring Dashboard" width="1200"/></p> |
77
- | <h3>📊 Datasets</h3>Export trace data or import external testcases to datasets hosted on Judgment's Platform. Move datasets to/from Parquet, S3, etc. <br><br>Run evals on datasets as unit tests or to A/B test different agent configurations. <br><br> **Useful for:**<br>• 🔄 Scaled analysis for A/B tests <br>• 🗃️ Filtered collections of agent runtime data| <p align="center"><img src="assets/datasets_preview_screenshot.png" alt="Dataset management" width="1200"/></p> |
78
- | <h3>💡 Insights</h3>Cluster on your data to reveal common use cases and failure modes.<br><br>Trace failures to their exact source with Judgment's Osiris agent, which localizes errors to specific components for precise fixes.<br><br> **Useful for:**<br>•🔮 Surfacing common inputs that lead to error<br>•🤖 Investigating agent/user behavior for optimization <br>| <p align="center"><img src="assets/dataset_clustering_screenshot_dm.png" alt="Insights dashboard" width="1200"/></p> |
79
-
80
- ## 🛠️ Installation
81
-
82
- Get started with Judgeval by installing our SDK using pip:
83
-
84
- ```bash
85
- pip install judgeval
86
- ```
87
-
88
- Ensure you have your `JUDGMENT_API_KEY` and `JUDGMENT_ORG_ID` environment variables set to connect to the [Judgment platform](https://app.judgmentlabs.ai/).
89
-
90
- **If you don't have keys, [create an account](https://app.judgmentlabs.ai/register) on the platform!**
91
-
92
- ## 🏁 Get Started
93
-
94
- Here's how you can quickly start using Judgeval:
95
-
96
- ### 🛰️ Tracing
97
-
98
- Track your agent execution with full observability with just a few lines of code.
99
- Create a file named `traces.py` with the following code:
100
-
101
- ```python
102
- from judgeval.common.tracer import Tracer, wrap
103
- from openai import OpenAI
104
-
105
- client = wrap(OpenAI())
106
- judgment = Tracer(project_name="my_project")
107
-
108
- @judgment.observe(span_type="tool")
109
- def my_tool():
110
- return "What's the capital of the U.S.?"
111
-
112
- @judgment.observe(span_type="function")
113
- def main():
114
- task_input = my_tool()
115
- res = client.chat.completions.create(
116
- model="gpt-4.1",
117
- messages=[{"role": "user", "content": f"{task_input}"}]
118
- )
119
- return res.choices[0].message.content
120
-
121
- main()
122
- ```
123
-
124
- [Click here](https://judgment.mintlify.app/getting_started#create-your-first-trace) for a more detailed explanation.
125
-
126
- ### 📝 Offline Evaluations
127
-
128
- You can evaluate your agent's execution to measure quality metrics such as hallucination.
129
- Create a file named `evaluate.py` with the following code:
130
-
131
- ```python evaluate.py
132
- from judgeval import JudgmentClient
133
- from judgeval.data import Example
134
- from judgeval.scorers import FaithfulnessScorer
135
-
136
- client = JudgmentClient()
137
-
138
- example = Example(
139
- input="What if these shoes don't fit?",
140
- actual_output="We offer a 30-day full refund at no extra cost.",
141
- retrieval_context=["All customers are eligible for a 30 day full refund at no extra cost."],
142
- )
143
-
144
- scorer = FaithfulnessScorer(threshold=0.5)
145
- results = client.run_evaluation(
146
- examples=[example],
147
- scorers=[scorer],
148
- model="gpt-4.1",
149
- )
150
- print(results)
151
- ```
152
-
153
- [Click here](https://judgment.mintlify.app/getting_started#create-your-first-experiment) for a more detailed explanation.
154
-
155
- ### 📡 Online Evaluations
156
-
157
- Attach performance monitoring on traces to measure the quality of your systems in production.
158
-
159
- Using the same `traces.py` file we created earlier, modify `main` function:
160
-
161
- ```python
162
- from judgeval.common.tracer import Tracer, wrap
163
- from judgeval.scorers import AnswerRelevancyScorer
164
- from openai import OpenAI
165
-
166
- client = wrap(OpenAI())
167
- judgment = Tracer(project_name="my_project")
168
-
169
- @judgment.observe(span_type="tool")
170
- def my_tool():
171
- return "Hello world!"
172
-
173
- @judgment.observe(span_type="function")
174
- def main():
175
- task_input = my_tool()
176
- res = client.chat.completions.create(
177
- model="gpt-4.1",
178
- messages=[{"role": "user", "content": f"{task_input}"}]
179
- ).choices[0].message.content
180
-
181
- judgment.async_evaluate(
182
- scorers=[AnswerRelevancyScorer(threshold=0.5)],
183
- input=task_input,
184
- actual_output=res,
185
- model="gpt-4.1"
186
- )
187
- print("Online evaluation submitted.")
188
- return res
189
-
190
- main()
191
- ```
192
-
193
- [Click here](https://judgment.mintlify.app/getting_started#create-your-first-online-evaluation) for a more detailed explanation.
194
-
195
- ## 🏢 Self-Hosting
196
-
197
- 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.
198
-
199
- ### Key Features
200
- * Deploy Judgment on your own AWS account
201
- * Store data in your own Supabase instance
202
- * Access Judgment through your own custom domain
203
-
204
- ### Getting Started
205
- 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
206
- 2. Use the [Judgment CLI](https://github.com/JudgmentLabs/judgment-cli) to deploy your self-hosted environment
207
- 3. After your self-hosted instance is setup, make sure the `JUDGMENT_API_URL` environmental variable is set to your self-hosted backend endpoint
208
-
209
- ## 📚 Cookbooks
210
-
211
- Have your own? We're happy to feature it if you create a PR or message us on [Discord](https://discord.gg/taAufyhf).
212
-
213
- You can access our repo of cookbooks [here](https://github.com/JudgmentLabs/judgment-cookbook). Here are some highlights:
214
-
215
- ### Sample Agents
216
-
217
- #### 💰 [LangGraph Financial QA Agent](https://github.com/JudgmentLabs/judgment-cookbook/blob/main/cookbooks/financial_agent/demo.py)
218
- A LangGraph-based agent for financial queries, featuring RAG capabilities with a vector database for contextual data retrieval and evaluation of its reasoning and data accuracy.
219
-
220
- #### ✈️ [OpenAI Travel Agent](https://github.com/JudgmentLabs/judgment-cookbook/blob/main/cookbooks/openai_travel_agent/agent.py)
221
- A travel planning agent using OpenAI API calls, custom tool functions, and RAG with a vector database for up-to-date and contextual travel information. Evaluated for itinerary quality and information relevance.
222
-
223
- ### Custom Evaluators
224
-
225
- #### 🔍 [PII Detection](https://github.com/JudgmentLabs/judgment-cookbook/blob/main/cookbooks/classifier_scorer/pii_checker.py)
226
- Detecting and evaluating Personal Identifiable Information (PII) leakage.
227
-
228
- #### 📧 [Cold Email Generation](https://github.com/JudgmentLabs/judgment-cookbook/blob/main/cookbooks/custom_scorers/cold_email_scorer.py)
229
-
230
- Evaluates if a cold email generator properly utilizes all relevant information about the target recipient.
231
-
232
- ## ⭐ Star Us on GitHub
233
-
234
- 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.
235
-
236
-
237
- ## ❤️ Contributors
238
-
239
- There are many ways to contribute to Judgeval:
240
-
241
- - Submit [bug reports](https://github.com/JudgmentLabs/judgeval/issues) and [feature requests](https://github.com/JudgmentLabs/judgeval/issues)
242
- - Review the documentation and submit [Pull Requests](https://github.com/JudgmentLabs/judgeval/pulls) to improve it
243
- - Speaking or writing about Judgment and letting us know!
244
-
245
- <!-- Contributors collage -->
246
- [![Contributors](https://contributors-img.web.app/image?repo=JudgmentLabs/judgeval)](https://github.com/JudgmentLabs/judgeval/graphs/contributors)
247
-