Skip to content


Repository files navigation


License: MIT

An application for interacting with Azimuth.


The latest version of Bridge is accessible online at No setup needed.

If you would rather host Bridge on your own machine, read on.


Python 3.7.2



  1. Download a release
  2. Unzip it (bridge-$
  3. Open up your command line interface (Terminal on MacOS, Command Prompt on Windows)
  4. cd into the bridge-$version directory

Verify checksums

Optionally, to validate your downloaded file's integrity, compare the lines in checksum.txt to SHA-256 hashes of the bridge-$version directory's contents.

  • On MacOS: shasum -a 256 -c checksums.txt .
  • On Linux: sha256sum -c checksums.txt .
  • On Windows: Go into the build directory and verify files individually with CertUtil -hashFile [file_name] SHA256

Run Bridge

  1. cd into the bridge-$version directory
  2. Run python3 -m http.server 5000 --bind
  3. Navigate to using a web browser to access Bridge (we recommend using Firefox or Chrome)

Ledger support

If you plan to authenticate with a Ledger, Bridge must be serving over HTTPS on localhost. This requires self-signed certificates. To do this:

  1. Install mkcert
  2. Install a local certificate authority via mkcert -install
  3. From the bridge-$version directory, run mkcert localhost to generate a certificate valid for localhost. This will produce two files: localhost.pem, the local certificate, and localhost-key.pem, its corresponding private key
  4. Run python
  5. Navigate to https://localhost:4443 in a web browser to access Bridge

Bridge without internet access

A proper "offline mode" for the latest iteration of Bridge is still being worked on. In the mean time, if you need to use Bridge on an airgapped machine, use Bridge v1.4.1.



Configurable Roller Endpoint

By default, Bridge uses Tlon's L2 Roller, but can also be configured to use your own.

For example: npm run pilot-mainnet

The following are configurable, and will otherwise fallback to the defaults in constants:

  • VITE_ROLLER_TRANSPORT_TYPE - transport type (e.g., http or https)