Shield Shield Assistant User Privacy Guide

Shield NOYB: User Privacy Guide


Table of Contents

  1. Why This Guide Exists
  2. The Core Promise: End-to-End Encryption Assured
  3. Encryption: Scrambling Your Messages
  4. The Local Vault: Locking Your Stored Data
  5. The Verification Panel: Checking System Integrity
  6. Where Your Data Lives (And Where It Does Not)
  7. Document Handling: Files Stay Local
  8. Your AI Companion: Personas and Profile Learning
  9. Language Support
  10. Mobile Use
  11. Data Export and Backup
  12. What Encryption Cannot Protect Against
  13. Quick Reference: Feature Checklist
  14. Glossary

1. Why This Guide Exists

You are using an AI chat application that was built from the ground up to keep your conversations private.

Shield NOYB involves three separate parties:

  1. Your browser – where you type messages and where all your data is stored.
  2. The server – a relay that routes your messages but cannot read them.
  3. The AI enclave – a sealed, hardware-protected environment where the AI runs. Even the people who operate the server cannot see inside it.

The system is designed so that the server never sees your message content, and the AI enclave processes your messages without knowing who you are.

This guide explains, in plain language, what privacy protections are in place, how they work, and what they can and cannot do. No technical background is required. Where a technical term is unavoidable, it is defined in the Glossary at the end of this guide.

This guide covers:


2. The Core Promise: End-to-End Encryption Assured

The fundamental problem: AI must read your actual words

Every AI chat application faces the same unavoidable constraint: the AI cannot think about encrypted text. To understand your question and write a reply, it must read your actual words in plain, unscrambled form. There is no way around this – it is how the technology works.

In most AI chat apps, this reading happens on the company’s servers. That means the company – and anyone who breaks into those servers, or any government that issues a legal demand – can see every message you have ever sent and every reply you have ever received. Even if the company promises not to look, the data is right there, readable, on machines they control.

You might wonder: can’t the AI just work on encrypted data without decrypting it? A technology called homomorphic encryption could theoretically do this, but it is far too slow and expensive for real use today. So every AI app that exists today must, at some point, read your actual words.

The question is not whether the AI reads your messages – it must. The question is where that reading happens, and who else can see it.

How Shield NOYB solves this with end-to-end encryption

Shield NOYB encrypts your messages before they leave your browser. They remain encrypted as they pass through the server. They are only decrypted inside a hardware-protected enclave – a sealed environment that even the server operator cannot see into. Replies follow the same path in reverse: encrypted inside the enclave, relayed through the server, decrypted only in your browser.

This is end-to-end encryption from your browser to the AI enclave, verified at every step:

The three parties

Understanding who is involved helps clarify why this design works:

Your browser is the only place where your data exists in readable form. All your conversations, memories, documents, and settings live here. Your browser encrypts messages before sending and decrypts replies after receiving.

The server sits in the middle. It handles your login, checks that you are authorized, and relays encrypted messages between your browser and the AI enclave. It can see that you are using the app, when, and the approximate size of your messages – but it cannot read them. Think of it as a postal service that delivers sealed packages without being able to open them.

The AI enclave is where the AI model runs. An enclave is a special hardware-protected environment – like a sealed room with no windows. Code running inside the enclave can process data, but nothing outside the enclave (including the server operator) can see what is happening inside. Before your browser sends any data, it verifies the enclave’s identity to confirm it is running the expected, audited software. Only after this verification passes does your browser establish the encrypted connection.

Analogy: A locked safe, a courier, and a sealed vault.

Imagine you write a letter, lock it in a safe, and hand the safe to a courier. The courier can see the safe – its size, when you sent it, where it is going – but cannot open it. The courier delivers the safe to a sealed vault: a special room that nobody can look into, not even the building owner. Inside the vault, an assistant opens the safe, reads your letter, writes a reply, locks the reply in a new safe, and places it outside the vault for the courier to pick up. The courier carries it back to you, still locked. Nobody except you and the assistant inside the sealed vault ever sees the letter.

In this analogy:

The courier is just a delivery service. The building owner (server operator) cannot see inside the vault. The assistant inside the vault does not know who sent the letter.


3. Encryption: Scrambling Your Messages

What happens when you send a message

Here is the journey your message takes, step by step:

  1. You type a message in Shield NOYB.
  2. Your browser scrambles (encrypts) the message before it leaves your device. The scrambled version is unreadable to anyone without the right key.
  3. The scrambled message passes through the server. The server checks that you are logged in and routes the message to the AI enclave, but it cannot read the contents. To the server, your message looks like random noise.
  4. The AI enclave unscrambles the message. Inside the sealed, hardware-protected enclave, the AI reads your message, processes your request, and generates a reply. Nothing outside the enclave can observe this step – not even the server operator.
  5. The reply is scrambled again before it leaves the enclave.
  6. The scrambled reply passes back through the server (still unreadable to the server).
  7. Your browser unscrambles the reply and displays it on your screen.

At no point does the server ever see the actual text of your message or the AI’s response. The AI enclave sees the content temporarily to generate a reply, but it does not know who you are (the server strips your identity before forwarding) and does not store your messages after processing.

How the AI enclave is verified

Before your browser sends any data, it verifies that the AI enclave is genuine and running the expected software. This verification is automatic and happens every time you start a secure conversation.

Your browser:

  1. Requests a certificate of identity from the enclave. This certificate is produced by the enclave’s hardware and cannot be forged.
  2. Checks the certificate against expected measurements – confirming the enclave is running the specific, audited code it claims to be running. This is like checking a tamper-evident seal: if the code inside has been changed, the seal will not match.
  3. Verifies the encryption key belongs to the authenticated enclave, not an impostor.
  4. Only after all checks pass does it establish the encrypted connection and begin sending data.

If any verification step fails, your browser refuses to send data and displays an error message explaining what went wrong. This protects you even if someone attempts to replace the genuine enclave with a fake one.

How to know encryption is active

When encryption is active, you will see “Secure (EHBP)” displayed in the Session panel under Transport mode. The status bar at the bottom of the screen also confirms the connection state.

If encryption is not active (for example, during development or testing), you will see “Legacy (JSON)” instead, and a status message will inform you that the secure transport is not available.

If you see “Legacy (JSON)”, your messages are not encrypted in transit. This mode exists only for development. In normal use, you should always see “Secure (EHBP)”.


4. The Local Vault: Locking Your Stored Data

What the vault does

Even though your conversations are stored only on your device, someone with access to your device (or your browser profile) could potentially read them. The Local Vault adds another layer of protection: it locks your stored data with a passphrase that only you know.

Without the passphrase, your stored conversations, messages, and memories are unreadable – even if someone copies your browser’s data files.

Analogy: A filing cabinet with a combination lock.

Your browser’s local storage is like a filing cabinet in your home. Without the vault, the cabinet is unlocked – anyone who walks into your home can open it. With the vault enabled, the cabinet has a combination lock. Only you know the combination.

How to use the vault

Setting up the vault (first time):

  1. Open the Settings panel.
  2. Find the “Local Vault” section.
  3. Enter a passphrase of your choice.
  4. Your existing data will be encrypted with this passphrase.

Unlocking the vault:

  1. When you open Shield NOYB, you will see a prompt to enter your vault passphrase.
  2. Enter your passphrase. Your conversations become readable.
  3. The vault stays unlocked for the duration of your session.

Locking the vault:

  1. Close the browser tab, or use the lock button in the vault section.
  2. Your data is now locked. Anyone who opens Shield NOYB on your device will see “Locked conversation” instead of the actual content.

What “Locked conversation” means:

If you see “Locked conversation” in your conversation list, it means the vault is locked and the data is encrypted. Enter your vault passphrase to unlock and view the content.

Important: your passphrase is unrecoverable

There is no “forgot password” option. If you forget your vault passphrase, your encrypted data cannot be recovered. Shield NOYB deliberately does not store your passphrase or any way to reset it – this is what makes the vault secure. No one, including the developers, can recover your data without the passphrase.

Recommendation: Choose a passphrase you can remember, or store it in a trusted password manager.


5. The Verification Panel: Checking System Integrity

Why verification matters

Encryption is only as good as the system running it. If someone tampered with the app’s code, or if the server were not following the privacy rules, encryption alone might not protect you. The verification panel lets you check, on demand, that each part of the system is working as expected.

Three trust checks

The verification panel displays three checks that work together. Each checks a different part of the connection:

Check 1: Client – “Is the code in my browser the audited code?”

What it checks: The app files served to your browser are compared with the selected published reference on IPFS, a network that gives content a fingerprint. A match means the files match that reference; the reference itself must be one you trust.

How it works: Your browser downloads its own code files and the published reference copies, then compares their digital fingerprints (hashes). If they match, the check passes.

Why it matters: This can reveal a difference from the published app. It runs after the page has loaded, so it is a useful check rather than a guarantee against every kind of tampering. It also relies on the checker and your browser being trustworthy.

Auditing the source: The compiled code you see in your browser is built from source files that are also published to IPFS. A technical auditor can fetch the source by its IPFS fingerprint, compile it using the documented tools, and confirm the result matches the compiled code fingerprint. This closes the loop: you can verify both what code runs and where it came from. The most critical source pin covers the Rust programs that generate the mathematical proofs (used in Check 2 below).

Check 2: Proxy – “Can this encrypted test pass through the relay securely?”

What it checks: Your browser creates two small test requests: one for a chat response and one for an embedding, the numerical representation used by search. It encrypts both before sending them through the Shield proxy. These tests contain fresh, made-up text, not your messages, files, or conversation history.

How it works:

  1. Your browser uses the public encryption key from the AI environment it has verified.
  2. It sends the encrypted tests through the Shield proxy. The secrets needed to read the exchange stay with your browser and the verified AI environment.
  3. The proxy returns forwarding proof receipts and the encrypted responses.
  4. Your browser checks that the proofs refer to the exact encrypted tests it created, the right session, and the expected destination.
  5. It checks and decrypts each response using the corresponding secret it kept locally. Both tests must return a valid result for the check to succeed.

What a successful check means: With a trustworthy client, correctly verified AI environment, and protected encryption secrets, the proxy receives ciphertext and is not given the secrets needed to decrypt these exchanges. The proof receipts connect the forwarding claims to your browser’s own tests; the response checks confirm that the encrypted exchanges worked. A receipt alone or an encryption label on a request is not enough.

What the proof adds: A mathematical proof confirms that a particular checking program accepted its recorded inputs. Your browser also verifies that those inputs match the test it actually made. This prevents accepting a valid proof about a different test as proof about yours. The browser’s response check is a separate, necessary part of the result.

What this does not mean:

Missing evidence is not a pass. If either proof or response is missing, inconsistent, expired where applicable, or cannot be authenticated, the encrypted test does not pass. A session receipt by itself does not replace the missing test evidence.

Each check sends two small real requests to the AI service. It can take longer than a normal status check because it waits for the responses and mathematical proofs. Background checks use fresh tests at intervals; they do not produce a proof for every chat message.

Check 3: Enclave – “Is the AI running in a secure environment?”

What it checks: The AI processing environment (the enclave) provides a certificate of its identity, which your browser verifies against expected measurements.

How it works: Before any data is sent, your browser verifies the enclave’s attestation document – essentially a tamper-evident seal on the AI environment. This happens automatically when you start a secure conversation.

Why it matters: This checks the environment against the accepted software measurements and connects its encryption key to that identity. The proxy test then uses that verified key. Attestation does not eliminate bugs in the accepted software or every hardware risk.

How to use the verification panel

  1. Look at the status indicator in the top area of the interface. It shows the current verification state.

  2. Click the indicator to open the verification panel with detailed information about each check.

  3. Run the checks:

    • The Enclave check runs automatically when you start a secure conversation.
    • The Client and Proxy checks can be run by clicking the respective check buttons in the panel.
  4. Read the results:

Indicator Meaning Action needed
Verified Private (green) The client, proxy test, and enclave checks passed for the current verification state Check again when the result expires or changes
Check Shield (gray) Enclave is verified, but client/proxy checks not yet run Run the client and proxy checks when ready
Client Check Needed (amber) Enclave and proxy OK, but client not checked or mismatched Run the client check
Proxy Check Needed (amber) Enclave and client OK, but proxy receipt missing or expired Run the proxy check
Full Check Needed (amber) Enclave OK, but both client and proxy need checking Run both checks
Unverified (red) Enclave verification failed or not attempted Do not send sensitive data until resolved

What to do if a check fails


6. Where Your Data Lives (And Where It Does Not)

On your device (in your browser)

All of the following are stored exclusively on your device:

On the server

The server stores only what it needs for authentication:

NOT on the server

The server does not store and cannot access:

What the server can see (metadata)

Even with encryption active, the server can observe certain metadata:

Quick reference table

Data On your device On the server Server can read it?
Conversation text Yes No No
AI responses Yes No No
Uploaded documents Yes (parsed locally) No No
Memories and context Yes No No
Persona settings Yes No No
Learned profile Yes No No
Vault passphrase In your memory only No No
Login email Yes (cookie) Yes Yes
Auth tokens In browser memory Yes (issued them) Yes
Message timing Observable Observable Yes (metadata)
Message size (encrypted) Observable Observable Yes (metadata)
Your IP address N/A Observable Yes (metadata)

7. Document Handling: Files Stay Local

How document parsing works

When you attach a document to a conversation (PDF, Word, Excel, PowerPoint, or text files), Shield NOYB parses the document entirely in your browser. The server never receives the file or its contents.

Supported formats:

Format How it is parsed
Plain text (.txt, .md, .csv, .html, .htm, .asciidoc) Read directly by your browser (no extra tools needed)
PDF (.pdf) Parsed using a specialized library loaded in your browser
Word (.docx) Parsed using a specialized library loaded in your browser
Excel (.xlsx, .xls) Parsed using a specialized library loaded in your browser
PowerPoint (.pptx) Parsed using your browser’s built-in capabilities

What happens to the parsed text

  1. Your browser reads the file and extracts the text content.
  2. The extracted text is added to your message as context for the AI.
  3. The text is included in the encrypted message sent to the AI (so the server still cannot read it).
  4. The original file stays on your device. It is not uploaded anywhere.

Analogy: Reading a book at home, then calling a friend to discuss it.

Imagine you read a book in your living room, take some notes, then call a friend to discuss it. Your friend hears your summary and notes, but never sees the book itself. The phone company (the server) carries your call but cannot understand it because you are speaking in code (encryption). The book never leaves your home.

A note about parsing libraries

For PDF, Word, and Excel files, your browser loads a small specialized tool (library) from the internet the first time you use that file type. These tools only read files – they do not send data anywhere. After loading, they work entirely within your browser.


8. Your AI Companion: Personas and Profile Learning

Personas: changing how the AI communicates

Shield NOYB comes with five built-in communication styles (personas) that change how the AI responds to you:

Persona What it does
Default Balanced, standard assistant behavior
Verbose Detailed, thorough responses with examples and explanations
Concise Short, direct answers – gets to the point quickly
Friendly Warm, conversational, and encouraging tone
ICANNOTTELLALIE Maximum honesty mode – prioritizes accuracy over agreeability

Creating custom personas:

You can also create your own personas with custom instructions. For example, you could create a “Teacher” persona that explains things as if you are a student, or a “Coder” persona that always includes code examples.

Where personas are stored:

All persona settings – both built-in and custom – are stored on your device in your browser’s local storage. The server does not know which persona you are using or what custom personas you have created.

How to change personas:

Select your preferred persona from the Persona dropdown in the settings panel. The change takes effect immediately for your next message.

Profile learning: the AI remembers your preferences

Shield NOYB can learn about your communication style and preferences over time. This is entirely optional and happens on your device.

How it works:

  1. After you have a conversation with at least four messages, Shield NOYB analyzes the conversation (using the AI, through the same encrypted channel) to extract patterns.
  2. It learns things like:
    • Your communication style (formal, casual, technical, etc.)
    • Topics you frequently discuss
    • Your preferences (how you like information presented)
    • Patterns in your interactions
  3. This profile is stored on your device and used to personalize future conversations.

Your control over profile learning:

Privacy of profile learning:


9. Language Support

Shield NOYB is available in four languages:

Language Code
English en
Japanese ja
Indonesian id
Traditional Chinese zh

The interface language can be changed in the Settings panel. The AI itself responds in whatever language you write to it, regardless of the interface language setting.

All language translations are built into the app and work entirely in your browser. No translation requests are sent to the server.


10. Mobile Use

Shield NOYB works on mobile devices (iOS and Android) through a dedicated app wrapper. The mobile version uses the same browser engine and the same code as the desktop version.

All the same privacy protections apply on mobile:

There are no additional privacy trade-offs when using the mobile version.


11. Data Export and Backup

Exporting your conversations

You can download your conversations as a file for backup or personal records:

  1. Open the Export panel from the menu.
  2. Select the conversations you want to export (up to 50 at a time).
  3. Click the download button.
  4. A JSON file will be saved to your device, named shield_conversations_YYYY-MM-DD.json.

Important notes about export

There is no server-side backup

Because your data is stored only in your browser, there is no automatic cloud backup. If you clear your browser data, switch browsers, or use a different device, your conversations will not be there. Use the export feature to create backups.


12. What Encryption Cannot Protect Against

No security system is perfect. Here is an honest account of the limitations:

Compromised device

If your computer or phone has malware (a virus, spyware, or a malicious browser extension), it could potentially read your data before it is encrypted or after it is decrypted. Private Assistant’s encryption protects data in transit and at rest, but it cannot protect against software that has access to your browser’s memory.

What you can do: Keep your device and browser updated. Avoid installing untrusted browser extensions. Use antivirus software.

Forgotten vault passphrase

If you set up the Local Vault and forget your passphrase, your encrypted data is permanently inaccessible. There is no recovery mechanism – by design. This is the trade-off for genuine security: no one else can recover your data either.

What you can do: Use a memorable passphrase or store it in a trusted password manager. Export your conversations regularly as a backup.

The AI processing step

When the AI processes your message, it necessarily sees the unscrambled (decrypted) content inside the enclave. This is by design – the AI cannot respond to a message it cannot read. The enclave is hardware-protected so that nobody outside it (including the server operator) can observe this step. However, you are trusting that:

The enclave also does not know who you are – the server strips your identity before forwarding. So even inside the enclave, your message is anonymous.

Timing and size patterns

The server can see when you use the app, how often, and the approximate size of your encrypted messages. It cannot read the content, but these patterns could theoretically reveal usage habits. For example, someone observing the server could tell that you had a long conversation at 3 PM, but not what it was about.

The web trust model

When you load Shield NOYB in your browser, you are trusting the server to send you the genuine, unmodified application code. If the server were compromised, it could potentially send modified code that undermines the privacy protections. The Client check in the verification panel (Section 5) is designed to detect this, but it requires you to actively run the check.

Document parsing library trust

When you first parse a PDF, Word, or Excel document, your browser downloads a small specialized tool from the internet. While these tools only process files locally and do not send data anywhere, they come from a third-party source. A theoretical attack on that source could deliver modified tools. The impact would be limited to the document parsing step – it could not bypass the encryption system.


13. Quick Reference: Feature Checklist

Feature What it protects How to check or enable
Secure transport (EHBP) Messages in transit between you and the AI enclave Check the Transport mode in the Session panel – should show “Secure (EHBP)”
Local Vault Stored conversations on your device Enable in Settings > Local Vault. Enter a passphrase.
Client verification Detects modified application code Open verification panel, run Client check
Proxy verification Checks two encrypted test exchanges and their forwarding proofs Open verification panel, run Proxy check
Enclave verification Confirms AI runs in genuine, sealed hardware enclave Automatic when starting a secure conversation
Local document parsing Keeps uploaded files on your device Automatic – just attach a file
Profile learning control Your learned preferences Toggle in Settings > Profile Learning
Data export Backup your conversations Use the Export panel in the menu
Persona selection AI communication style Select in the Persona dropdown
Language selection Interface language Select in Settings > Language

14. Glossary

Attestation A tamper-evident certificate that proves a secure computing environment (enclave) is running specific, expected software. Like a notarized document that confirms identity.

Enclave A hardware-protected computing environment where the AI runs. The protection is enforced by the hardware itself, not just by software promises – even the operator of the server cannot see what is happening inside. Think of it as a sealed vault with no windows: data goes in, results come out, but nobody outside can peek in or tamper with the process. Your browser verifies the enclave’s identity (via attestation) before sending any data.

Encryption The process of scrambling data so that it is unreadable without the correct key. Like converting a letter into a secret code that only the intended recipient can decode.

End-to-end encryption Encryption where the data is scrambled by the sender (your browser) and can only be unscrambled by the intended recipient (the AI enclave). No one in between – not the server, not the network provider, not even the server operator – can read the content.

EHBP (Encrypted HTTP Body Protocol) The specific encryption method used by Shield NOYB to scramble message bodies. It uses industry-standard cryptographic algorithms (the same family of algorithms used by major security protocols worldwide).

IPFS (InterPlanetary File System) A public, decentralized network for storing files. Files on IPFS are identified by their content – a unique fingerprint (hash) of the data. This means if the content changes, the fingerprint changes too, making tampering detectable. Shield NOYB publishes both its compiled code and its source code on IPFS so you can verify you are running the genuine version and auditors can confirm the code was built from the published source.

Passphrase A password used to lock your data vault. Unlike a typical password, a passphrase can be a longer phrase that is easier to remember (e.g., “correct horse battery staple”). Private Assistant uses your passphrase to derive the encryption key for your local vault.

Proxy The server component that sits between your browser and the AI environment. It handles login, routes your encrypted messages, and adds the necessary credentials – but cannot read the message content. Like a mail carrier that delivers sealed packages.

Receipt (verification receipt) A record containing a signed statement or mathematical proof. The Shield checker compares its contents with the session and encrypted tests it requested. The receipt is one part of verification; the browser also has to authenticate the test responses.

Zero-knowledge proof A cryptographic proof that a specified checking program accepted its inputs, without requiring the verifier to repeat the whole computation. In Shield, the browser must also check that the proven inputs match its own encrypted test. A proof does not, by itself, watch everything the proxy does.


This guide was originally written in March 2026. Its verification section was updated in September 2026 to describe the client-created encrypted checks in the WIP implementation. The document is not confirmation that a particular live installation has been updated. For detailed technical information, see the companion document: Technical White Paper.