DMJBot - Personal AI Assistant

DMJBot Bridge

Wiki

DMJBot Bridge

DMJBot Bridge is the application you install on a machine to connect it to DMJBot as a device. It is a small Python tool that runs on the device and exposes the MCP servers running there to the bot, so the bot can use them to do work on the device. It runs on any platform with Python — Windows, Mac, Linux, and even some IoT devices.

For what a device is, why you connect one, and how device access is kept secure, see the Devices page. This page covers installing and running the bridge.

Once the bridge is installed and running, you connect the device to the bot by adding it in Settings → Devices and using the connect URL shown there.

Installing DMJBot Bridge

Requirements:

  • Python 3.11+ (with stdlib venv module)

Note: uv is the recommended and best option to install and manage DMJBot Bridge.

Linux and macOS

Install using the hosted installer:

curl -fsSL https://dmjbot.com/bridge/install.sh | bash

Windows (PowerShell)

iwr -useb https://dmjbot.com/bridge/install.ps1 | iex

Optional install variants

# Beta channel
curl -fsSL https://dmjbot.com/bridge/install.sh | CHANNEL=beta bash

# Pin exact version
curl -fsSL https://dmjbot.com/bridge/install.sh | VERSION=0.2.0 bash

# Force venv backend (instead of auto-detect)
curl -fsSL https://dmjbot.com/bridge/install.sh | INSTALL_MODE=venv bash

Verify installation

dmjbot-bridge --version

Usage

Quick command summary for daily work with DMJBot Bridge.

Basic bridge commands

dmjbot-bridge --help
dmjbot-bridge connect <connect_url>
dmjbot-bridge start
  • connect: connects this device to DMJBot using the connect URL from Settings -> Devices.
  • start: runs bridge in foreground mode using local config.

Manage MCP servers

dmjbot-bridge list
dmjbot-bridge installed
dmjbot-bridge installed --check-updates
dmjbot-bridge catalog
dmjbot-bridge info <name>

Install/update/remove:

dmjbot-bridge install <project> [--channel latest|beta|<version>] [--name <name>]
dmjbot-bridge configure <name>
dmjbot-bridge update <name> | --all
dmjbot-bridge remove <name>
dmjbot-bridge enable <name> | disable <name>

Add custom servers:

dmjbot-bridge add
dmjbot-bridge add my-api --http https://host/mcp --header "Authorization:Bearer xyz"
dmjbot-bridge add my-tool --command /usr/bin/foo --arg=--port=3000 --env TOKEN=abc

Service mode (run in background)

dmjbot-bridge service install
dmjbot-bridge service status
dmjbot-bridge service logs
dmjbot-bridge service stop
dmjbot-bridge service start
dmjbot-bridge service uninstall

See also

  • Devices — what devices are and how device access is kept secure.
  • Tools and MCP — the MCP servers you can install on a device.