>

SyftBox is the browser to the broad listening internet, but it's less like a browser, and more like:

A file-syncing system which you share with the rest of the internet (note: the internet is a giant filesystem)
with novel file permissions based on privacy enhancing technologies (which protect you)
and background tasks which reply to questions people ask you while you're away.

Below you can see the network of people connected to the broad listening internet. By the end of this page, you'll see your name here too!

> Step 1.1: Install UV

UV is a package manager that we'll use to manage our Python dependencies. Install it by running the following command in your terminal:

curl -LsSf https://astral.sh/uv/install.sh | sh

This command downloads and executes the installation script for UV.

> Step 1.2: Activate UV

After installing UV, you need to activate it. You have two options:

  1. Restart your terminal
  2. Run one of the following commands based on your shell:

For sh, bash, or zsh shells:

source $HOME/.cargo/env

For fish shell:

source $HOME/.cargo/env.fish

> Step 1.3: Create a Virtual Environment

Now, let's create a virtual environment for our project:

uv venv .venv

This command creates a new virtual environment named ".venv" in your current directory.

> Step 1.4: Install SyftBox

With our virtual environment set up, we can now install SyftBox:

uv pip install http://20.168.10.234:8080/wheel/syftbox-0.1.0-py3-none-any.whl --reinstall

This command installs (or reinstalls) the SyftBox wheel from the specified URL.

> Step 1.5: Run the SyftBox Client

Finally, let's run the SyftBox client:

uv run syftbox client

This command starts the SyftBox client, connecting you to the broad listening network. If this is your first time, the client will ask you several questions.

Once you've answered the questions and the SyftBox client has started, look for your email on the network.

> Congratulations!

You've successfully installed and run SyftBox. You're now ready to explore the broad listening internet!