Kiji Privacy Proxy v1.1.2

Kiji Privacy Proxy v1.1.2

Downloads

• macOS: DMG installer (Apple Silicon and Intel) - Desktop app with UI
• Linux: Standalone binary archive (amd64) - API server only (no UI)
• Linux (.deb): Debian/Ubuntu package (amd64) with systemd unit
• Chrome Extension: Browser extension for PII detection in web forms

macOS Installation

Quick Start:

1. Download Kiji-Privacy-Proxy-1.1.2.dmg
2. Open the DMG and drag to Applications
3. Launch "Kiji Privacy Proxy"

HTTPS Support - Install CA Certificate:

For HTTPS interception to work, you must trust the proxy's CA certificate:

# System-wide trust (recommended)
sudo security add-trusted-cert \
  -d \
  -r trustRoot \
  -k /Library/Keychains/System.keychain \
  ~/.kiji-proxy/certs/ca.crt

Or use Keychain Access:

1. Open Keychain Access app
2. File → Import Items → ~/.kiji-proxy/certs/ca.crt
3. Double-click "Kiji Privacy Proxy CA" certificate
4. Expand Trust → Set to Always Trust

Linux Installation

Note: Linux build is API-only (no desktop UI). Access via HTTP endpoints.

Quick Start:

# Extract
tar -xzf kiji-privacy-proxy-1.1.2-linux-amd64.tar.gz
cd kiji-privacy-proxy-1.1.2-linux-amd64

# Run
./run.sh

HTTPS Support - Install CA Certificate:

# Ubuntu/Debian
sudo cp ~/.kiji-proxy/certs/ca.crt /usr/local/share/ca-certificates/kiji-proxy-ca.crt
sudo update-ca-certificates

# RHEL/CentOS/Fedora
sudo cp ~/.kiji-proxy/certs/ca.crt /etc/pki/ca-trust/source/anchors/kiji-proxy-ca.crt
sudo update-ca-trust

Configuration:

# Set API key
export OPENAI_API_KEY="your-key-here"

# Check health
curl http://localhost:8080/health

# Test proxy
curl -x http://localhost:8080 https://api.openai.com/v1/models

See included README.txt for systemd service setup and advanced configuration.

Debian / Ubuntu (.deb)

sudo dpkg -i kiji-privacy-proxy_1.1.2_amd64.deb
# The systemd unit is installed but not enabled by default.
# Configure /etc/default or env vars first, then:
sudo systemctl enable --now kiji-privacy-proxy

Files land under /opt/kiji-privacy-proxy/ and a kiji-proxy
wrapper is placed on PATH at /usr/bin/kiji-proxy.

Chrome Extension

Install from zip:

1. Download kiji-privacy-proxy-extension-1.1.2.zip
2. Unzip to a folder
3. Open chrome://extensions/
4. Enable Developer mode
5. Click Load unpacked and select the unzipped folder

Documentation

• Getting Started Guide
• Development Guide
• Release Management

What's New

See the changelog below for details.

What's Changed

• chore: contributing.md by @hanneshapke in #449
• chore: add Youssef Jouini to contributors list by @yjouini in #455
• fix: made tests os dependent by @hanneshapke in #456
• fix: handle duplicated entities by @hanneshapke in #469
• fix: persistent mapping by @hanneshapke in #468
• fix: updated downloader by @hanneshapke in #467
• fix: refactored electron-main.js by @hanneshapke in #473
• feat: add link to Kiji Chrome Extension by @hanneshapke in #476
• ci: register homebrew tap auth smoke-test workflow by @hanneshapke in #477
• ci: updated workflow for debugging by @hanneshapke in #478
• feat: log Chrome extension PII checks to /logs by @hanneshapke in #479
• ci: updated test workflow by @hanneshapke in #480
• fix: rewrote provider for openai, handling schema and response by @hanneshapke in #472
• feat: extract hardcoded proxy ports as named constants by @ykd007 in #439
• ci: homebrew setup by @hanneshapke in #395
• fix: refactored electron-main.js by @hanneshapke in #474
• feat: create deb package by @hanneshapke in #394
• fix: removed terms by @hanneshapke in #481
• fix: dependabot 20260529 by @hanneshapke in #482
• ci(deps): bump golangci/golangci-lint-action from 9.2.0 to 9.2.1 in the github-actions group by @dependabot[bot] in #466
• deps(deps-dev): bump electron from 42.1.0 to 42.3.0 by @dependabot[bot] in #450
• ci(deps): bump actions/create-github-app-token from 2 to 3 in the github-actions group across 1 directory by @dependabot[bot] in #483
• deps(deps-dev): bump @babel/preset-env from 7.29.5 to 7.29.7 by @dependabot[bot] in #451
• feat: add feature request issue template by @ykd007 in #442
• chore: minor version bump by @hanneshapke in #484
• chore: version packages by @github-actions[bot] in #485
• fix: deb release by @hanneshapke in #486
• chore: version packages by @github-actions[bot] in #487
• fix: deb release v2 by @hanneshapke in #488
• chore: version packages by @github-actions[bot] in #489

New Contributors

• @yjouini made their first contribution in #455
• @ykd007 made their first contribution in #439

Full Changelog: v1.0.5...v1.1.2