This release is a pre-release and may not be stable for production use.
Passport
Your information. Your choice of what to share.
Passport is an independent, open-source personal-information vault from Toll Bench. It encrypts information in your browser and lets you export selected information as a separately encrypted package. The standalone application runs locally without an account, AI provider, telemetry or cloud storage. A separate hosted client connects encrypted storage to an authenticated host through an isolated frame.
Status: 0.1.0a5 source candidate. Not independently security-audited. Includes the standalone reference application and a separate hosted client component. Use sample information while evaluating it. The published standalone release remains unchanged. See hosted embedding and security responsibilities.
Run it
Published alpha: python -m pip install toll-passport==0.1.0a4, then toll-passport serve. See the verified release receipt.
Python 3.9 or later and a current browser with Web Crypto and IndexedDB are required. From a source checkout:
python3 -m venv .venv
. .venv/bin/activate
python -m pip install .
toll-passport serve
Open http://127.0.0.1:8765. Keep that exact address and port: browser storage is scoped to its origin. A different port or localhost is a different storage location. Install a released wheel with python -m pip install path/to/toll_passport-0.1.0a4-py3-none-any.whl. A GitHub release does not imply availability on PyPI; check the release notes.
What works
- Create a vault with an automatically generated encryption key.
- Save notes, structured answers, optional labels and multiple files locally.
- Find saved answers for an exact subject and task context, review their source and age, and explicitly fill the local answer form.
- Encrypt titles, tags, filenames and contents before writing browser storage.
- Lock and unlock using a separate recovery file.
- Export an encrypted backup and restore it into another browser.
- Select exact fields from an exact record version; preview and export an independently encrypted sharing package.
- Open a received sharing package locally and save it in your vault.
- Remove records or remove the local vault; existing exported copies remain.
The contact information itself can be stored as information. CRM workflows, contact lists, goals, action packs, recurrence, agent dispatch, marketplace payments and reputation belong to Toll Bench and are outside this project.
Recovery and storage
Creation automatically requests a recovery-file download. Store that file securely, separately from your encrypted backups. It contains the key that unlocks the entire vault. Export a new encrypted backup after changes. Recovery requires both the backup and recovery file if browser storage is lost. No operator can reset a lost key. Browser storage can be cleared, evicted or unavailable; it is not a backup.
The unlocked key is kept in page memory, not IndexedDB, localStorage or the Python server. Refreshing, closing or locking the page requires the recovery file again. A compromised device or browser extension may read unlocked information. This alpha has no passkeys, OS keychain integration, password protection or multi-device synchronization.
Files are limited to 25 MiB each; the encrypted snapshot is limited to 100 MiB. Base64 encoding, metadata and versions consume some of that space. The local server only serves five static assets on loopback and accepts no uploads. It is not a remote deployment server.
Sharing
Only explicitly selected fields are copied into a release. The original vault key is never used as the sharing key. Download the encrypted package and its separate package key, then deliver them through appropriate separate channels. Passport itself sends nothing.
The recipient and purpose are authenticated package metadata, not verified recipient identity or access control. Anyone possessing the package and key can decrypt it. Downloads cannot be recalled, revoked or made to expire. Hosted grants, verified recipient keys and delivery authorization are later work, documented in the integration boundary.
Optional question labels
A question-producing application may suggest a stable question key. Subject, task reference and reuse scope come from trusted owner context. The reference UI accepts optional labels including unfamiliar ones. Recognized labels can find saved answers for matching context; the owner reviews candidates and explicitly chooses an answer to fill the form. Missing labels never prevent saving, fail an agent or affect a score. Answers remain private until selected for release. Automatic agent question intake remains separate work. Question metadata contract.
Development
Runtime code has no third-party package dependencies: Python standard library and browser Web Crypto only. No third-party JavaScript or fonts are loaded.
python -m pip install build twine
python -m build
python -m twine check dist/*
python -m pip install dist/*.whl
python -m unittest discover -s tests -p 'test_*.py' -v
node --test tests/*.test.mjs
Node 22 is used for core tests. Browser checks use Playwright as a development-only dependency; see verification. CI tests and builds the distributable. Publishing is a separate manual, tag-bound workflow with PyPI Trusted Publishing; it requires account-side setup described in releasing.
Ownership and attribution
Copyright 2026 Steven Ochs and Tollbench. Created for Toll Bench. Licensed under Apache-2.0; preserve NOTICE with redistributions as applicable. This license applies to Passport's included source, not the private Toll Bench application or its trademarks. See third-party notices and citation metadata.
This is newly authored Passport code. No Ente, Bitwarden or proprietary Toll Bench implementation was copied. Cryptographic primitives are supplied by Web Crypto; this is not a new encryption algorithm. See security and format before extending the reference implementation.
Metadata
Release files for toll-passport 0.1.0a5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| toll_passport-0.1.0a5.tar.gz | 55.3 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| toll_passport-0.1.0a5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 94.2 kB
Release files / toll_passport-0.1.0a5.tar.gz
| Download URL | toll_passport-0.1.0a5.tar.gz |
|---|---|
| Size | 55.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
34984a91703a98c8dd8a3a64089c678cd2241ee0c8b3e6b8cc630602ea510e12
|
|
BLAKE2b-256 checksum How to use checksums |
cbd5b26402ed13795f1aeec226b7a045d019ee2708dd3f38b6a377269728596e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.
Transparency logRelease files / toll_passport-0.1.0a5-py3-none-any.whl
| Download URL | toll_passport-0.1.0a5-py3-none-any.whl |
|---|---|
| Size | 38.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ceddeae445006516c67aff5814e63421b275513e515c23fa8037dac4fb8630bc
|
|
BLAKE2b-256 checksum How to use checksums |
0dcdf12b026c601df86f1d69122f22abad83f210e8d0ddf43109265b4a5e7771
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.
Transparency logSecurity for toll-passport 0.1.0a5
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for toll_passport-0.1.0a5.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.