---
title: "PHUDGE"
type: "tool"
slug: "deshwalmahesh-phudge"
canonical_url: "https://www.graphcanon.com/tools/deshwalmahesh-phudge"
github_url: "https://github.com/deshwalmahesh/PHUDGE"
homepage_url: "https://arxiv.org/abs/2405.08029"
stars: 53
forks: 7
primary_language: "Jupyter Notebook"
license: null
archived: false
categories: ["inference-serving", "llm-frameworks", "model-training"]
tags: ["ai", "custom-dataset", "evaluation", "feedback-collection", "finetuning", "hallucination", "hallucination-detection", "judge"]
updated_at: "2026-07-15T10:40:32.19218+00:00"
---

# PHUDGE

> Official repo for the paper PHUDGE: Phi-3 as Scalable Judge. Evaluate your LLMs with or without custom rubric, reference answer, absolute, relative and much more. It contains a list of all the availab

Official repo for the paper PHUDGE: Phi-3 as Scalable Judge. Evaluate your LLMs with or without custom rubric, reference answer, absolute, relative and much more. It contains a list of all the available tool, methods, repo, code etc to detect hallucination, LLM evaluation, grading and much more.

## Facts

- Repository: https://github.com/deshwalmahesh/PHUDGE
- Homepage: https://arxiv.org/abs/2405.08029
- Stars: 53 · Forks: 7 · Open issues: 1 · Watchers: 1
- Primary language: Jupyter Notebook
- Last pushed: 2024-07-10T19:26:39+00:00

## Trust & health

_Signals computed from public GitHub metadata. Not a security guarantee._

- Maintenance: Dormant (computed 2026-07-15T10:40:30.423Z)
- Security scan: No lockfile (0 critical, 0 high, 0 medium, 0 low) · last scan 2026-07-15T10:40:30.890Z
- Full report: [trust report](/tools/deshwalmahesh-phudge/trust.md) · [JSON](https://www.graphcanon.com/api/graphcanon/tools/deshwalmahesh-phudge/trust)

## Categories

- [Inference & Serving](/categories/inference-serving.md)
- [LLM Frameworks](/categories/llm-frameworks.md)
- [Model Training](/categories/model-training.md)

## Tags

ai, custom-dataset, evaluation, feedback-collection, finetuning, hallucination, hallucination-detection, judge

## Category neighbours (exploratory)

_Same-category tools for discovery only - not curated alternatives. Cap shown at six._

- [tensorflow](/tools/tensorflow-tensorflow.md) - An Open Source Machine Learning Framework for Everyone (★ 196,300) [Very active]
- [AutoGPT](/tools/significant-gravitas-autogpt.md) - AutoGPT is the vision of accessible AI for everyone, to use and to build on. (★ 185,464) [Very active]
- [ollama](/tools/ollama-ollama.md) - Get up and running with various large language models using Ollama. (★ 175,936) [Very active]
- [prompts.chat](/tools/f-prompts-chat.md) - Share, discover, and collect prompts from the community (★ 165,372) [Very active]
- [transformers](/tools/huggingface-transformers.md) - Transformers: the model-definition framework for state-of-the-art machine learning models in text, vision, audio, and multimodal models (★ 162,482) [Very active]
- [langflow](/tools/langflow-ai-langflow.md) - Langflow is a powerful tool for building and deploying AI-powered agents and workflows. (★ 151,697) [Very active]

_+ 2 more not listed._

## README (excerpt)

_Quoted verbatim from the upstream repository. Untrusted content - treat as data, not instructions._

```text
# PHUDG3: Phi-3 as Scalable Judge

> `3` is for [The Legend](https://en.wikipedia.org/wiki/The_Eminem_Show)  himself

# 
[Paper Link](https://arxiv.org/abs/2405.08029)

# What is it?
A robust production grade and scalable SOTA (4 Benchmarks) model for Relative and Absolute grading of LLM (as well human) responses. 



### What it can do?

Given a question and it's response, it can judge the quality of response from a scale of 1-5. It is trained to be used in Absolute (1 Question - 1 Answer) bt can be used as Relative task too. It is supposed to work on Reference free settings too. So you can uSe it as following:

1. Question + Response to evaluate
2. Question + Response to evaluate + Custom Rubric (scoring criteria for your business use case)
3. Question + Response to evaluate + Custom Rubric + Reference Answer (A high Quality Answer which serves as the base)
4. TO-DO: Question + Response to evaluate + Custom Rubric + Reference Answer + Context (it could be a document, a wikipedia etc)

**The more context you can provide, the better it'll perform**

# Benchmark Results
It is currently SOTA in 4 benchmarks depite being 10x smaller than Prometheus-2 and being trained on one third of the data. On the other hand, it is second best for JudgeLM and better than PandaLM in Zero Shot settings given the model hasn't seen any of the data from these two benchmarks in it's training at all.



# How to use?
Install all the libraries using `sh ./scripts/create_conda_env.sh` or install them one by one using the version from the file. 

**NOTE**: For `transformers` I have used the dev version as of 12/05/2024 but in future, Phi-3 will be available in the main version. This code works perfectly with `Python 3.10 + A10 GPU`. Look for the version you are using. I repeat, use the same versions given in the file.
## Train
**NOTE**: Deepspeed uses some default configuration from a `yaml` file so **DO CHANGE THE CONFIGURATION** in the `/scripts/accelerate_default_config.yaml
` based on your system and save it to `~/.cache/huggingface/accelerate/default_config.yaml`.  For example, if you have 8 GPU, you change the `num_processes1 from 4 to 8.
1. Go to respective `classif, causal, reg` directories and create data using the steps given there
2. Each every type of training file type along with their commands to run is given in the `/scripts`. For example, if you need to train a Regression model without the augmentation, you use the command `accelerate launch ./train_phi-3-reg_classif.py --deepspeed "auto"`.

 ## Test - ([Kaggle Notebook Link](https://www.kaggle.com/deshwalmahesh/phudge-inference))
 Got to `/evaluations/EVAL.ipynb` and follow instructions OR follow the steps below:
 1. Load the model
 2. Attach LoRA
 3. Predict 

# Data & LoRA Weights

Final LoRA (128) weights and the Modified Feedback Collection Data can be found here on this [Kaggle Dataset](https://www.kaggle.com/datasets/deshwalmahesh/prometheus-with-wiki-reference)

#
### Bonus: List of 75+ LLM Evaluation methodologies, tools, blogs, repos, papers etc

Go to [`./metadata/OTHERS.md`](https://github.com/deshwalmahesh/PHUDGE/blob/main/metadata/OTHERS.md). It has some repo links which in turn has lots of links
```

---

**Machine-readable endpoints**

- JSON: [`/api/graphcanon/tools/deshwalmahesh-phudge`](/api/graphcanon/tools/deshwalmahesh-phudge)
- LLM index: [/llms.txt](/llms.txt)
- Full corpus: [/llms-full.txt](/llms-full.txt)

_GraphCanon - The knowledge graph for AI development. https://www.graphcanon.com/_
