Private Facts is a web app to track your private info. This project was originally developed at https://github.com/blaisep/private_facts/tree/main; previous commit history can be found there.

This repo holds the source code and resource files for the project described at private-facts.readthedocs.io The code intends to be a demonstration of how to use Tahoe-lafs and better understand the concept of "provider-independent security" as it pertains to Tahoe-lafs.

There are several ways you can use this repo:

• as a companion to the tutorials at private-facts.readthedocs.io
• as the starting point for a project of your own
• as a practical guide to setting up a local development instance of Tahoe-lafs

We encourage you to read through the docs first and get an overall sense of the narrative arc. Later, if you want the hands-on experience, clone the repo and go through the instructions.

These instructions assume you are using uv for project management; if you use another approach, you will have to modify some of the commands below. Project dependencies are listed in pyproject.toml.

git clone [email protected]:private-facts/private-facts.git && cd private-facts

git clone https://github.com/private-facts/private-facts.git && cd private-facts

uv sync

uv run tahoe-server/storage0
uv run tahoe-server/client0

just dev

which will start both processes in their own tmux panes and focus a third pane.

uv run hello
uv run hello_file
uv run hello_system
uv run hello_mutable

just stop

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

To run the tests:

uv run pytest

just test

GNU General Public License v3 //: # ( This file was inspired by https://www.makeareadme.com/ )