Skip to content

About

Local Windows document vault with scoped temporary read access and revocation

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

DataSovereign 1.0

Italiano · Downloads · API · Security

Local import, delegation, reading and revocation

DataSovereign is a local document vault for one Windows user. Import encrypted copies, choose exactly which documents an application can read, and give it a temporary token. The vault records access decisions and lets you revoke a delegation at any time.

Install and start

Requires Windows and Python 3.11 or later. Download the wheel from GitHub Releases and open PowerShell in your download folder:

python -m pip install .\datasovereign-1.0.0-py3-none-any.whl
python -m datasovereign serve

From a source checkout, use python -m pip install . instead. Open the local URL printed in the terminal. Keep the link private. Its administrator key remains valid until you stop the server with Ctrl+C.

In the dashboard, create a collection, import documents and select the files to share. Copy the delegation token when it appears. For an AI agent, grant only the documents it needs and keep its environment separate from the original folders. The application sends Authorization: Bearer <token> to the local API. New imports never join an existing delegation. Restoring a file from trash requires new consent.

Upgrade from the alpha

Stop the old service and save a copy of the vault directory with the service stopped. If you installed the old package, uninstall it with python -m pip uninstall datasovereign-alpha, then install 1.0. The default directory stays at %LOCALAPPDATA%\DataSovereign\alpha. Use the same --data-dir if you set a custom directory. The first open migrates the database and saves a metadata copy called vault.pre-beta.db. Existing delegations retain the documents available at migration time. Review and revoke them if needed. Use the saved vault copy if you need to run the older version again.

Backup, export and integrity

  • Encrypted backup (64 MiB): documents and manifest use Windows DPAPI. Restore with the same Windows account and device into an empty vault. Recovered delegations are revoked.
  • Plaintext export (50 MiB): active documents and metadata in ZIP format, for portability. Store it securely.
  • Integrity: run python -m datasovereign doctor or use the dashboard to check readability. Each imported document can be up to 10 MiB.

The API is loopback only. Programs that already run as your Windows user can access the original files and may be able to access vault data directly. The SQLite metadata is plaintext. A recipient can keep copies it already downloaded. The application audit can be changed by someone with direct access to the database. See the threat model before using sensitive documents.

Code is licensed under AGPL-3.0-only. See licensing, contribution terms, support, and the development plan.

Support the project

To support maintenance, use the repository's Sponsor button or visit Ko-fi, Buy Me a Coffee or PayPal.

About

Local Windows document vault with scoped temporary read access and revocation

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages