Installing the jutellaxmpp executable
Assuming you have Rust/Cargo installed , run this command in a terminal:
cargo install jutella-xmpp
It will make the jutellaxmpp command available in your PATH if you've allowed the PATH to be modified when installing Rust . cargo uninstall jutella-xmpp uninstalls.
Back to the crate overview .
Readme
jutella-xmpp
XMPP LLM bridge based on tokio-xmpp and jutella .
Supports OpenAI (including Azure auth flavor) and OpenRouter chat completions API.
Features
Allowlist of user JIDs with wildcards.
Rolling context window with min/max token limits (see the config parameters description for details).
Presence, read receipts & composing notifications.
Image & PDF file attachments.
Image generation (only with OpenRouter, no multi-turn editing support).
Installation
Install the executable
Install cargo from https://rustup.rs/ .
Install jutella-xmpp from crates.io with cargo install jutella-xmpp .
The executable will be installed as $ HOME /.cargo/bin/jutellaxmpp.
Alternatively, clone the repo and build the executable with cargo build -- release . The resulting executable will be target/ release/ jutellaxmpp .
Copy the executable to /usr/local/bin .
Create a user for runnig the daemon
sudo useradd -- system -- shell /sbin/nologin -- home-dir /nonexistent jutella
Install the config
Copy the config example to /etc .
Make it readable by jutella group:
sudo chmod 640 /etc/jutellaxmpp.toml
sudo chown root:jutella /etc/jutellaxmpp.toml
Edit the config to match your configuration.
Install the systemd service
Copy systemd service to /etc/systemd/system .
Enable it to run on system startup: sudo systemctl enable jutellaxmpp.service .
Start the service: sudo systemctl start jutellaxmpp.service .