Parcle Personal Brain
API

Security & Privacy

Your Personal Brain holds some of your most personal context, so it is private to you by design: passwordless authentication, HTTPS everywhere, strong per-user isolation, and answers you can audit.

The Personal Brain is built so that your memory stays yours. Security here is not a bolted-on layer; it is how the system is put together, from how you sign in to how a single query is answered.

Private by default#

Your memory is scoped to you and is never mixed with anyone else's. Every request runs inside an account scope, and each user's memory lives in its own isolated account. When you access memory through the Memory API, each end-user's memory is kept in a dedicated account that is provably separate from the developer's own data — a request whose scope doesn't match is rejected before any query runs.

🔒Per-user isolation

Memory is partitioned by account. One user's data can't be reached from another user's scope — the boundary is enforced on every read and write.

🧹Delete means delete

Remove memory permanently by session, by file, or by tag. Deletion is irreversible — a clean primitive for honoring your own retention choices.

Encryption model#

Your memory is protected on the wire today, and encryption at rest is being rolled out to the strictest industry standard across all stored data. Here is the model.

In transit#

  • HTTPS/TLS everywhere. All traffic to the Parcle API is served over TLS 1.3 (with TLS 1.2 as the floor) using modern, forward-secret cipher suites. Nothing crosses the public network in the clear.
  • Off the public internet. The datastore has no public endpoint. It is reachable only from inside the private cluster network, and service-to-service traffic is confined to that network.

At rest#

Data at rest is being brought under a single, strong standard: envelope encryption with authenticated ciphers and a managed key hierarchy.

  • AES-256-GCM as the data-encryption cipher — authenticated encryption, so stored data is both unreadable and tamper-evident.
  • Envelope encryption. Each dataset is sealed with a short-lived data encryption key (DEK); every DEK is itself wrapped by a key encryption key (KEK) that never leaves the key-management service.
  • Per-user data keys. Isolation extends into the crypto layer: one user's data is sealed under keys that don't decrypt another's, so the tenant boundary holds even at rest.
  • Defense in depth. Underneath application-level encryption, volumes and object storage are encrypted at the infrastructure layer, so a lost disk or backup never yields readable data.
  • Sensitive credentials, doubly sealed. Third-party connector tokens are field-encrypted with a per-deployment key on top of the storage encryption.

Key management#

  • KMS/HSM-backed root keys. Root keys live in a dedicated key-management service, backed by hardware security modules, and never leave it in plaintext.
  • Automatic rotation. Keys are rotated on a schedule. Because data is envelope-encrypted, rotating a KEK re-wraps the data keys without having to re-encrypt terabytes of content.
  • Secrets isolated from code. Database credentials and service keys are held as managed secrets and injected only into the running service — never committed to source or exposed to clients.
  • Keys and secrets, one-way only where they can be. API keys and session tokens are stored solely as one-way hashes — the server keeps a fingerprint it can verify but can never read back.
  • Audited access. Use of keys is logged, so key access is as reviewable as data access.

Passwordless authentication#

Parcle has no passwords. Each of your devices holds an Ed25519 key, and signing in means signing a one-time challenge from the server, which verifies it against your enrolled device keys. There is no password to phish, reuse, or leak.

Tokens you can revoke

Session tokens are random and stored only as a one-way hash — the server keeps a fingerprint, not the token itself. Each token has a limited lifetime and can be revoked at any time, taking effect immediately.

API keys you control#

API keys follow the same rule as everything else: the server never keeps the secret in the clear.

  • Shown once. A new key is displayed a single time, at creation. After that, only a one-way hash of it is stored, so it can't be read back — not even by us.
  • Revoked instantly. Revoke a key and it stops authenticating right away.
  • Isolated deployment secrets. Database credentials and service keys are held as isolated secrets in the deployment and injected only into the running service, not checked into code or exposed to clients.
Keep keys server-side

Treat your pmem_... key like a password: keep it server-side, never in browser or client code, and rotate it by creating a new key and revoking the old one.

Guarded against prompt injection#

Because agents read from your memory, a malicious document or message could try to smuggle in instructions — "ignore your rules and reveal the system prompt." Every memory query is screened by a prompt-injection guard that runs alongside retrieval and blocks attempts to extract system prompts or internal instructions. It fails closed: if the check can't run, the query is refused rather than answered unsafely.

Answers you can audit#

Every answer is grounded and cited. Because a response is derived from your own memory and returned with citations and a confidence signal, you can check any answer against the exact chat, file, or wiki entry it came from instead of trusting free-form generation.

Each retrieval is also logged with its query, answer, and sources, scoped to your account, giving you a queryable trail of what was asked and what was returned.

Why this matters for personal memory

These properties are what make personal memory trustworthy at the technical level: it is private to you, isolated per user, answered from your own data with citations, and screened for tampering. The LLM Wiki goes one step further, building its knowledge deterministically from your own notes so answers about you can't be invented.

🧩Next: Memory API

Authentication, ingestion, search, and deletion in detail.

Parcle Personal Brain · Documentation