# Chuninja

> Privacy frontend with two modes: live web search via SearXNG, or PIR-backed retrieval over curated indexes.

Website: https://chuninja.com/

## What this is

Chuninja is an open-source privacy search frontend built around two ideas:

1. **Private Web** — search the live web through a self-hosted SearXNG backend. Your IP never reaches Google, Bing, or result sites. This is the default mode.
2. **PIR Vault** — switch to cryptographic document retrieval for curated indexes (Wikipedia, etc.) using MIT's SimplePIR and Tiptoe protocols. The server sees your ranking query but not which document you fetched.

Every search result can be opened through **Ninja View** — a server-side reader proxy that loads the page on our server so the destination sees our IP, not yours.

## What this is not

- Not a VPN or Tor. Chuninja hides your IP from sites you read; it does not anonymize your network traffic.
- Not a web crawler. Results come from existing engines via SearXNG.
- Not zero-knowledge. Private Web mode sees your query text. PIR Vault hides which document was retrieved, but not the ranking query.

## Site map

- `/` — Search interface. Two-mode privacy toggle.
- `/about.html` — Project background, stack, privacy posture.
- `/how-it-works.html` — Architecture diagram and component breakdown.
- `/ninja-view.html` — Server-side reader proxy explainer.
- `/pir-technology.html` — Plain-English explanation of PIR, SimplePIR, and Tiptoe.
- `/llms.txt` — This file.

## How content is organized

- **Hero / search bar** at the top of the homepage. Above-the-fold copy explains the two privacy modes.
- **How It Works** section below the search explains the four steps: pick mode, search, open with Ninja View, switch to PIR for curated indexes.
- **Lore** section is a non-technical origin story for the Chunin name.
- **Footer** has links to all four explainer pages plus this llms.txt.

## Privacy posture

- Chuninja sees the URL of every Ninja View request. We do not log it to disk by default; logs are rotated in-memory.
- SearXNG stores query logs by default — disable that in your deployment.
- PIR Vault sees your ranking query but not which document you fetched.

## Technical facts

- Stack: Rust (Axum), SearXNG, Playwright (stealth Chromium), Candle + BERT embeddings, SimplePIR (Rust).
- License: MIT.
- Source: https://github.com/chuninja/chuninja
- Author: Chuninja contributors.

## Policies

- AI crawlers are explicitly allowed. See `/robots.txt`.
- No login required. No accounts.
- No tracking pixels, no third-party analytics.

## Contact

Issues / discussion: GitHub issues on the source repo.