LeSysBot docs
LeSysBotVersion 0.1.0

Chat with the machine you own.

A local AI assistant you can chat with via CLI, Telegram, or Discord — extended by tools you drop into a folder. The model runs on your own hardware, so the machine it controls and the model reading your messages are both yours.

Get started Tool reference

Telegram · LeSysBot

how hot is the machine right now?

temperature()CPU 41–47°C across 16 cores · GPU 38°C. Nothing to worry about.

the render finished — shut it down

power_off()⚠️ This will POWER OFF the machine in 1 minute. Proceed?

yes

Powering off in 60 seconds. Say cancel shutdown if you change your mind.

Install it

One command, no questions. It sorts out Python, Ollama and a model, then configures itself.

Getting started

See what it can do

12 packages and 19 tools — disk usage, temperatures, network checks, powering the machine down, sharing a dashboard.

Tool reference

Teach it something new

A folder with a README and a tool.py is a tool. Drop it in and it works — no restart, no plugin API.

Write a tool

Four steps to a working bot

  1. 1

    Install it

    One command. It gets Python and Ollama ready, pulls a model, and configures everything — no questions asked.

    curl -fsSL https://lesysbot.github.io/install.sh | sh
  2. 2

    Say hello

    Talk to it in the terminal before wiring up a chat app.

    lesysbot chat
  3. 3

    Open the control panel

    Settings, tools and health in a browser. The service keeps it online.

    http://127.0.0.1:8700
  4. 4

    Add tools and dashboards

    Pull in the official cross-platform collection — one repo, every OS.

    lesysbot install lesysbot/lesysbot-packages-official

Tools for every platform

The bundled set works everywhere. Beyond that, each OS gets a collection built on its own interfaces — hwmon sensors on Linux, pmset and the SMC on macOS, WMI thermal zones on Windows. None of them needs root.

Bundled

8 packages · 13 tools

system-info, date-time, power, cpu-temp, gpu-temp, speedtest, web, share-dashboard

Official packages

4 packages · 6 tools

network, temperature, battery, speedtest

Watch the machine over time

A one-off "how hot is it?" only tells you about now. Every install sets up a Prometheus + Grafana stack that records CPU, memory, disk, network — Ethernet and Wifi separately — temperatures and NVIDIA GPU as time series, on a dashboard built for the OS you are on.

The installer wires it up and starts it — nothing to configure. Everything binds to 127.0.0.1, and none of it needs sudo.

open http://localhost:3000~/.lesysbot/monitoring/scripts/start.sh down

Then ask the bot for it from anywhere — share_dashboard publishes an expiring public snapshot you can send to someone, and takes it back down when you are done.

System monitoring share-dashboard

Telegram · LeSysBot

share me the dashboard

share_dashboard(expiration="1h")📊 Dashboard shared — expires in 1h:
snapshots.raintank.io/dashboard/snapshot/xY7…

Anyone with this link can view a snapshot of your system metrics.

ok take it down

delete_snapshot(which="1")Deleted. The public link is gone.

All documentation

Introduction

Start here

Everyday use

Give it new abilities

Keep it running

Under the hood