bifrost-agent

Mac path-tunnel agent for Bifrost. Connects outbound over WebSocket and exposes a local HTTP app under Bifrost’s tunnels base path (default /tunnels/{slug}).

Install

pipx install bifrost-agent
# or: pip install bifrost-agent  (inside a venv)

Requires Python 3.11+.

Connect

  1. In Bifrost Console → Tunnels, create a tunnel and attach a path route (set Local URL there, e.g. http://127.0.0.1:3000).
  2. Copy the one-time install command and run:
sudo bifrost tunnel install <token>

The token embeds the Bifrost WebSocket URL and auth secret. Local upstream URLs are not passed on the CLI — they come from the console on each request.

You can install multiple tokens on one Mac; each gets its own LaunchDaemon and instance id.

Commands

sudo bifrost tunnel install <token>     # add/replace one instance
bifrost tunnel list                     # id, state, url, logs path
bifrost tunnel logs <id>                # last lines of that instance
bifrost tunnel logs <id> -f             # follow logs
sudo bifrost tunnel uninstall <id>      # remove one instance
sudo bifrost tunnel uninstall --all     # remove every instance
bifrost version

list example:

a1b2c3d4e5f6
  state:   running
  url:     wss://bifrost.enfeca.cloud/api/v1/tunnel/connect
  logs:    /Library/Logs/bifrost-tunnel-a1b2c3d4e5f6.log

Per-instance paths:

  • Config: /Library/Application Support/bifrost/instances/<id>/config.json
  • Logs: /Library/Logs/bifrost-tunnel-<id>.log
  • LaunchDaemon: com.bifrost.tunnel.<id>

A pre-0.2.0 install appears as instance id legacy.

Develop

python -m venv .venv
source .venv/bin/activate
pip install -e .
bifrost version
bifrost tunnel list

Publish

Repo: https://github.com/eskeon/bifrost-agent

Tag a release (v*); GitHub Actions builds and publishes to PyPI as bifrost-agent.

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.2.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for spiraldeveloper from gravatar.com spiraldeveloper

Credits

Author: Bifrost

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Tags

bifrost tunnel websocket

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bifrost_agent-0.2.0.tar.gz (8.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

bifrost_agent-0.2.0-py3-none-any.whl (10.8 kB view details)

Uploaded Python 3

File details

Details for the file bifrost_agent-0.2.0.tar.gz.

File metadata

  • Download URL: bifrost_agent-0.2.0.tar.gz
  • Upload date:
  • Size: 8.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for bifrost_agent-0.2.0.tar.gz
Algorithm Hash digest
SHA256 3d5cb69efcaad8e3a906872edc2bb18f20d6b9a5262951528e3c63608c394fe5
MD5 ac7c049385430e4570f6cd6b99ab8c54
BLAKE2b-256 c4eb332494f1f3f68144bb67515075163e0284572c0b35ee60aff012f1991b6c

See more details on using hashes here.

Provenance

The following attestation bundles were made for bifrost_agent-0.2.0.tar.gz:

Publisher: publish.yml on eskeon/bifrost-agent

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file bifrost_agent-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: bifrost_agent-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 10.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for bifrost_agent-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 85200bc4fc95e2edd51eb2c9ed6c697853648a6d6895662f4b08acd1fd89c3c7
MD5 41fc883022cc4ebd3d01d4c321553868
BLAKE2b-256 d19d0fe82c47131718ebad979e58d49a3dc8d3b17f6fdaa7675377f55f6fba34

See more details on using hashes here.

Provenance

The following attestation bundles were made for bifrost_agent-0.2.0-py3-none-any.whl:

Publisher: publish.yml on eskeon/bifrost-agent

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page