explaingit

sure-scale/hey-jude

Analysis updated 2026-06-24

33PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

An LLM proxy that pseudonymizes names, emails, and phone numbers in prompts locally before forwarding to OpenAI, Anthropic, or Gemini, then restores the originals in the reply.

Mindmap

mindmap
  root((hey-jude))
    Inputs
      Raw prompt with PII
      OpenAI Anthropic Gemini call
    Outputs
      Pseudonymized prompt
      Restored response
    Use Cases
      Legal workflow privacy
      Data minimization
      Local PII scrubbing
    Tech Stack
      Python
      Ollama
      Docker Compose
      Redis
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a local proxy that strips client names and emails out of prompts before sending to OpenAI

USE CASE 2

Point existing OpenAI SDK code at hey-jude with only a base URL change

USE CASE 3

Route cleaned prompts through LiteLLM to Azure, Gemini, or Anthropic

USE CASE 4

Add a privacy layer for legal-tech tooling without rewriting application code

What is it built with?

PythonOllamaDockerRedisLiteLLMQwen

How does it compare?

sure-scale/hey-jude410979729/scope-recallarahim3/mlx-dspark
Stars333333
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/53/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs Ollama on the host plus Docker Compose for Redis, the default local model must be pulled before the gateway will scrub anything.

AGPL-3.0: free to use and modify, but any networked service built on it must also be released under AGPL-3.0.

In plain English

Hey Jude is an open-source proxy that sits in front of large language model calls and tries to reduce the amount of sensitive information those models ever see. It is aimed at legal workflows, where prompts often contain client names, organization names, email addresses, and phone numbers that should not be shipped to a third-party model without first being scrubbed. The README is clear that this is a helper layer for data minimization, not a guarantee of complete detection, and it should be used alongside other confidentiality measures. The gateway works by spotting common personal and organizational details in your prompt, swapping them with safer synthetic values, sending the cleaned-up prompt onward to the model you actually want to use, and then attempting to restore the original details in the response that comes back. The pseudonymization step itself is done by a local model, usually run through Ollama, so the raw text never has to leave your machine just to be cleaned. It exposes OpenAI, Anthropic, and Gemini compatible endpoints, which means existing client code written for those SDKs can be pointed at the gateway with very few changes. The README shows short Python and Node examples for both the OpenAI and Anthropic SDKs, where the only real change is the base URL and the API key. The default setup is meant to run end-to-end on your own laptop without any cloud API key. You install Ollama, pull a small Qwen model, clone the repo, copy the example env file, and start it with Docker Compose. Redis runs in the Docker stack and Ollama runs on the host. Once it is up, a test script confirms the gateway is reachable on port 4005. Advanced users can swap in larger local models, switch to Apple MLX, or route the cleaned prompt to OpenAI, Anthropic, Gemini, Azure, or any LiteLLM-compatible provider by setting the right environment variables. The project is released under the AGPL-3.0 license.

Copy-paste prompts

Prompt 1
Stand up hey-jude on my Mac with Ollama and Docker Compose and confirm port 4005 responds.
Prompt 2
Swap the default Qwen model in hey-jude for a larger local model and document the trade-offs.
Prompt 3
Show me how to point my existing OpenAI Python client at hey-jude by changing only the base URL.
Prompt 4
Audit hey-jude's pseudonymization rules for the kinds of PII a UK law firm would care about.

Frequently asked questions

What is hey-jude?

An LLM proxy that pseudonymizes names, emails, and phone numbers in prompts locally before forwarding to OpenAI, Anthropic, or Gemini, then restores the originals in the reply.

What language is hey-jude written in?

Mainly Python. The stack also includes Python, Ollama, Docker.

What license does hey-jude use?

AGPL-3.0: free to use and modify, but any networked service built on it must also be released under AGPL-3.0.

How hard is hey-jude to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is hey-jude for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.