Plans Sign In Register
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

Share this machine's Ollama

If you run Ollama on this machine, the bridge can offer its models to DMJBot — including a DMJBot running on a server or in the cloud. The prompts and the answers stay on your machine: DMJBot only sends the request over the same secure device connection and reads the reply.

dmjbot-bridge enable-ollama                        # the standard http://127.0.0.1:11434
dmjbot-bridge enable-ollama http://127.0.0.1:11500 # a non-standard port
dmjbot-bridge enable-ollama http://192.168.0.5:11434
dmjbot-bridge enable-ollama <host> --username <user> --password <pass>
dmjbot-bridge enable-ollama <host> --skip-verify    # save without probing
dmjbot-bridge disable-ollama

The address is optional and may be any host and port; http:// is assumed when you leave the scheme out. An Ollama on another machine has to be started with OLLAMA_HOST=0.0.0.0:11434 there, or it will refuse the connection — Local models over the bridge covers that case.

enable-ollama checks that the server answers and lists the models it found before saving, marking the ones that can also read images. Restart the bridge afterwards for the link to come up:

dmjbot-bridge service stop && dmjbot-bridge service start

Then, in the bot: Settings → Models → Device Models → Enable, and pick the model from the list (it is grouped by device). See Local models over the bridge for the whole workflow.

Status

dmjbot-bridge status

One screen with everything: which DMJBot this device is connected to, whether the background service is running, the configured MCP servers, and whether the local Ollama is shared. dmjbot-bridge list also shows the Ollama line under the server table.

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