lonoboard 0.1.0__tar.gz

lonoboard-0.1.0/LICENSE

@@ -0,0 +1,29 @@
+MIT License
+
+Copyright (c) 2026 Zachary Taylor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+The fonts in src/lonoboard/static/fonts/ (PxPlus_IBM_VGA_8x16.ttf and
+PxPlus_IBM_VGA_9x16.ttf) are from The Ultimate Oldschool PC Font Pack by VileR
+(https://int10h.org/oldschool-pc-fonts/) and are licensed separately under the
+Creative Commons Attribution-ShareAlike 4.0 International License; see
+src/lonoboard/static/fonts/LICENSE-CC-BY-SA-4.0.txt.

lonoboard-0.1.0/PKG-INFO

@@ -0,0 +1,193 @@
+Metadata-Version: 2.4
+Name: lonoboard
+Version: 0.1.0
+Summary: A live dashboard for the machines running your AI models, drawn like a 1990s ANSI BBS
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ztaylor/lonoboard
+Project-URL: Issues, https://github.com/ztaylor/lonoboard/issues
+Project-URL: Changelog, https://github.com/ztaylor/lonoboard/blob/main/CHANGELOG.md
+Keywords: bbs,ansi,ansi-art,telnet,llama.cpp,ollama,vllm,llm,dashboard,homelab
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Terminals :: Telnet
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: src/lonoboard/static/fonts/LICENSE-CC-BY-SA-4.0.txt
+Dynamic: license-file
+
+# lonoboard
+
+[![CI](https://github.com/ztaylor/lonoboard/actions/workflows/ci.yml/badge.svg)](https://github.com/ztaylor/lonoboard/actions/workflows/ci.yml)
+
+**A live dashboard for the machines running your AI models, drawn like a 1990s ANSI BBS.**
+
+Telnet in, or open a browser, and you get a live board for that machine. It shows the models
+it serves, their memory and GPU use, requests and tokens per second, an event log, and a chat
+window for talking to the models. Everything is drawn in CP437 and the CGA palette, the way
+ACiD and iCE drew it.
+
+    telnet gpu-box 2323           # any terminal; SyncTERM or NetRunner for the full effect
+    http://gpu-box:7777/          # the same board in a browser
+
+![lonoboard: the main screen, the services lightbar and a chat](https://raw.githubusercontent.com/ztaylor/lonoboard/main/docs/media/hero.gif)
+
+It works with llama.cpp, Ollama, vLLM and any OpenAI-compatible server. It finds them on its
+own, and you can also list them in a config file. It runs on NVIDIA, AMD, Apple Silicon or a
+plain CPU. It's a single Python program with no dependencies.
+
+## Try it
+
+    pipx install lonoboard
+    lonoboard demo            # a simulated machine, with a fake chat
+    lonoboard check           # what lonoboard finds on this machine
+    lonoboard                 # the real board, on localhost
+
+Or try it without installing: `uvx lonoboard demo`.
+
+Python 3.11 or newer. Then open <http://localhost:7777/> or run `telnet localhost 2323`.
+
+<table>
+<tr><td><img src="https://raw.githubusercontent.com/ztaylor/lonoboard/main/docs/media/main.png" alt="The main screen"></td>
+<td><img src="https://raw.githubusercontent.com/ztaylor/lonoboard/main/docs/media/services.png" alt="Services, with live details"></td></tr>
+<tr><td><img src="https://raw.githubusercontent.com/ztaylor/lonoboard/main/docs/media/chat.png" alt="Chatting with a model"></td>
+<td><img src="https://raw.githubusercontent.com/ztaylor/lonoboard/main/docs/media/usage.png" alt="Requests per hour and the top 10"></td></tr>
+<tr><td><img src="https://raw.githubusercontent.com/ztaylor/lonoboard/main/docs/media/fleet.png" alt="Viewing another machine in the fleet"></td>
+<td><img src="https://raw.githubusercontent.com/ztaylor/lonoboard/main/docs/media/amber.png" alt="Amber monochrome"></td></tr>
+</table>
+
+## The board
+
+The board is made of **screens**, each sized to your window:
+
+| key | screen   | what's on it |
+|-----|----------|--------------|
+| `M` | main     | logo, system stats, GPU memory by service, recent requests, the menu, the event log |
+| `S` | services | every model server on a lightbar; on wide windows, slot activity and live details |
+| `H` | host     | system stats, memory, GPU, slot activity |
+| `U` | usage    | requests per hour over 24 h, and the top 10 by tokens today |
+| `R` | requests | recent requests: tokens, tok/s, prompt size and speed |
+| `E` | events   | services coming and going, generations starting and finishing |
+| `N` | network  | each service's URLs and API endpoints, other published ports |
+| `F` | fleet    | other machines running lonoboard; pick one to view its board |
+
+- **Moving around:**
+  - A letter jumps to a screen. `←` `→` flip between screens and `esc` goes back to main.
+  - `↑` `↓` move the lightbar, `enter` opens the selected item, and `1`–`9` open a service.
+  - A screen too tall for the window splits into pages. `space` reads on, `b` goes back.
+  - The mouse works: click entries, rows and links, and use the wheel to turn pages.
+- **Details** (`enter` on a service): status, model, context, last request, memory, the systemd
+  unit or container, endpoints, launch flags, and a live tail of its log.
+- **Chat** (`c`): talk to any chat model on the machine, and `tab` switches model. Replies
+  stream, reasoning collapses into a summary, and `esc` stops a reply. Conversations aren't
+  stored.
+- **Display** (`d`):
+  - IBM VGA 8x16 or 9x16 font.
+  - VGA colour, amber or green monochrome.
+  - iCE colours or blink for bright backgrounds.
+  - CRT effect.
+- `?` opens help. `q` quits a telnet session after asking first.
+
+### Terminals
+
+lonoboard negotiates echo, window size and terminal type, and adapts to what it finds:
+
+| terminal | what lonoboard sends |
+|----------|----------------|
+| modern (xterm, kitty, ghostty, WezTerm, PuTTY…) | UTF-8, hyperlinks, mouse reporting and the alternate screen |
+| anything else | classic CP437 ANSI-BBS with iCE colours |
+
+Colour depth is chosen separately:
+
+| terminal | colours |
+|----------|---------|
+| known to support 24-bit | exact VGA colours |
+| `*-256color` | the nearest xterm-256 colours |
+| everything else | the terminal's own 16 colours |
+
+<img src="https://raw.githubusercontent.com/ztaylor/lonoboard/main/docs/media/terminal.png" width="560" alt="The board in a classic 80x25 terminal">
+
+In a telnet session, press `d` and then `m` to cycle the colour mode, or `u` to switch between
+UTF-8 and CP437.
+
+## Model servers
+
+| server | found by | what lonoboard shows |
+|--------|----------|----------------|
+| llama.cpp | process or port | model, quant, params, context, slots and busy slots, per-request tok/s from its log |
+| Ollama | process or port 11434 | installed and loaded models, VRAM, requests from its log |
+| vLLM | `/metrics` | model, context, running requests, token counters |
+| OpenAI-compatible (LM Studio, …) | port or config | models, health, chat; optional API key |
+
+lonoboard finds the systemd unit or Docker container behind each server. That gives it state,
+uptime, restarts and logs. See [docs/sources.md](https://github.com/ztaylor/lonoboard/blob/main/docs/sources.md) for details.
+
+**Hardware:**
+- **NVIDIA** via `nvidia-smi`, including unified-memory systems like the DGX Spark.
+- **AMD** via `rocm-smi`.
+- **Apple Silicon** via `ioreg`.
+- **CPU-only.**
+
+## Running it for real
+
+    lonoboard install --now          # a systemd user service running `lonoboard serve`
+
+The board listens on **localhost only** until you say otherwise. To reach it from elsewhere:
+
+- **Tailscale** (recommended). Keep it on localhost and publish it with `tailscale serve`. lonoboard
+  then finds the other machines on your tailnet for the fleet screen.
+- **Your LAN.** Set `listen` and a `password`. lonoboard won't listen beyond localhost or your
+  tailnet without one. The password is asked for at a login prompt in the terminal, and the
+  API takes it as a bearer token.
+
+[SECURITY.md](https://github.com/ztaylor/lonoboard/blob/main/SECURITY.md) covers what the board shows and how it's protected.
+
+See [docs/deployment.md](https://github.com/ztaylor/lonoboard/blob/main/docs/deployment.md) for systemd, Tailscale, Docker and deploying to
+several machines over SSH, and [docs/public-demo.md](https://github.com/ztaylor/lonoboard/blob/main/docs/public-demo.md) for hosting a public
+demo board.
+
+## Configuration
+
+Nothing needs configuring, but everything can be. Settings go in `~/.config/lonoboard/config.toml`,
+or in a file named by `--config` or `$LONOBOARD_CONFIG`:
+
+```toml
+[board]
+tagline = "the attic box"
+
+[[server]]
+name = "lmstudio"
+url = "http://127.0.0.1:1234"
+kind = "openai"
+```
+
+[examples/config.toml](https://github.com/ztaylor/lonoboard/blob/main/examples/config.toml) lists every setting, and
+[docs/configuration.md](https://github.com/ztaylor/lonoboard/blob/main/docs/configuration.md) explains them.
+
+## JSON API
+
+Anything that doesn't ask for HTML gets JSON:
+
+    curl localhost:7777/              # host, services, other ports, fleet
+    curl localhost:7777/api/usage     # requests per hour, top 10
+
+See [docs/api.md](https://github.com/ztaylor/lonoboard/blob/main/docs/api.md) for every endpoint.
+
+## Credits
+
+- The fonts are `PxPlus_IBM_VGA_8x16` and `PxPlus_IBM_VGA_9x16`, from
+  [The Ultimate Oldschool PC Font Pack](https://int10h.org/oldschool-pc-fonts/) by VileR. They
+  are licensed CC BY-SA 4.0 and bundled, so the board works offline.
+- The look is inspired by the ANSI art groups of the 1990s: ACiD, iCE, Blocktronics and the
+  rest of the 16colo.rs archive.
+
+## License
+
+MIT, see [LICENSE](https://github.com/ztaylor/lonoboard/blob/main/LICENSE). The bundled fonts keep their CC BY-SA 4.0 license.

lonoboard-0.1.0/README.md

@@ -0,0 +1,168 @@
+# lonoboard
+
+[![CI](https://github.com/ztaylor/lonoboard/actions/workflows/ci.yml/badge.svg)](https://github.com/ztaylor/lonoboard/actions/workflows/ci.yml)
+
+**A live dashboard for the machines running your AI models, drawn like a 1990s ANSI BBS.**
+
+Telnet in, or open a browser, and you get a live board for that machine. It shows the models
+it serves, their memory and GPU use, requests and tokens per second, an event log, and a chat
+window for talking to the models. Everything is drawn in CP437 and the CGA palette, the way
+ACiD and iCE drew it.
+
+    telnet gpu-box 2323           # any terminal; SyncTERM or NetRunner for the full effect
+    http://gpu-box:7777/          # the same board in a browser
+
+![lonoboard: the main screen, the services lightbar and a chat](https://raw.githubusercontent.com/ztaylor/lonoboard/main/docs/media/hero.gif)
+
+It works with llama.cpp, Ollama, vLLM and any OpenAI-compatible server. It finds them on its
+own, and you can also list them in a config file. It runs on NVIDIA, AMD, Apple Silicon or a
+plain CPU. It's a single Python program with no dependencies.
+
+## Try it
+
+    pipx install lonoboard
+    lonoboard demo            # a simulated machine, with a fake chat
+    lonoboard check           # what lonoboard finds on this machine
+    lonoboard                 # the real board, on localhost
+
+Or try it without installing: `uvx lonoboard demo`.
+
+Python 3.11 or newer. Then open <http://localhost:7777/> or run `telnet localhost 2323`.
+
+<table>
+<tr><td><img src="https://raw.githubusercontent.com/ztaylor/lonoboard/main/docs/media/main.png" alt="The main screen"></td>
+<td><img src="https://raw.githubusercontent.com/ztaylor/lonoboard/main/docs/media/services.png" alt="Services, with live details"></td></tr>
+<tr><td><img src="https://raw.githubusercontent.com/ztaylor/lonoboard/main/docs/media/chat.png" alt="Chatting with a model"></td>
+<td><img src="https://raw.githubusercontent.com/ztaylor/lonoboard/main/docs/media/usage.png" alt="Requests per hour and the top 10"></td></tr>
+<tr><td><img src="https://raw.githubusercontent.com/ztaylor/lonoboard/main/docs/media/fleet.png" alt="Viewing another machine in the fleet"></td>
+<td><img src="https://raw.githubusercontent.com/ztaylor/lonoboard/main/docs/media/amber.png" alt="Amber monochrome"></td></tr>
+</table>
+
+## The board
+
+The board is made of **screens**, each sized to your window:
+
+| key | screen   | what's on it |
+|-----|----------|--------------|
+| `M` | main     | logo, system stats, GPU memory by service, recent requests, the menu, the event log |
+| `S` | services | every model server on a lightbar; on wide windows, slot activity and live details |
+| `H` | host     | system stats, memory, GPU, slot activity |
+| `U` | usage    | requests per hour over 24 h, and the top 10 by tokens today |
+| `R` | requests | recent requests: tokens, tok/s, prompt size and speed |
+| `E` | events   | services coming and going, generations starting and finishing |
+| `N` | network  | each service's URLs and API endpoints, other published ports |
+| `F` | fleet    | other machines running lonoboard; pick one to view its board |
+
+- **Moving around:**
+  - A letter jumps to a screen. `←` `→` flip between screens and `esc` goes back to main.
+  - `↑` `↓` move the lightbar, `enter` opens the selected item, and `1`–`9` open a service.
+  - A screen too tall for the window splits into pages. `space` reads on, `b` goes back.
+  - The mouse works: click entries, rows and links, and use the wheel to turn pages.
+- **Details** (`enter` on a service): status, model, context, last request, memory, the systemd
+  unit or container, endpoints, launch flags, and a live tail of its log.
+- **Chat** (`c`): talk to any chat model on the machine, and `tab` switches model. Replies
+  stream, reasoning collapses into a summary, and `esc` stops a reply. Conversations aren't
+  stored.
+- **Display** (`d`):
+  - IBM VGA 8x16 or 9x16 font.
+  - VGA colour, amber or green monochrome.
+  - iCE colours or blink for bright backgrounds.
+  - CRT effect.
+- `?` opens help. `q` quits a telnet session after asking first.
+
+### Terminals
+
+lonoboard negotiates echo, window size and terminal type, and adapts to what it finds:
+
+| terminal | what lonoboard sends |
+|----------|----------------|
+| modern (xterm, kitty, ghostty, WezTerm, PuTTY…) | UTF-8, hyperlinks, mouse reporting and the alternate screen |
+| anything else | classic CP437 ANSI-BBS with iCE colours |
+
+Colour depth is chosen separately:
+
+| terminal | colours |
+|----------|---------|
+| known to support 24-bit | exact VGA colours |
+| `*-256color` | the nearest xterm-256 colours |
+| everything else | the terminal's own 16 colours |
+
+<img src="https://raw.githubusercontent.com/ztaylor/lonoboard/main/docs/media/terminal.png" width="560" alt="The board in a classic 80x25 terminal">
+
+In a telnet session, press `d` and then `m` to cycle the colour mode, or `u` to switch between
+UTF-8 and CP437.
+
+## Model servers
+
+| server | found by | what lonoboard shows |
+|--------|----------|----------------|
+| llama.cpp | process or port | model, quant, params, context, slots and busy slots, per-request tok/s from its log |
+| Ollama | process or port 11434 | installed and loaded models, VRAM, requests from its log |
+| vLLM | `/metrics` | model, context, running requests, token counters |
+| OpenAI-compatible (LM Studio, …) | port or config | models, health, chat; optional API key |
+
+lonoboard finds the systemd unit or Docker container behind each server. That gives it state,
+uptime, restarts and logs. See [docs/sources.md](https://github.com/ztaylor/lonoboard/blob/main/docs/sources.md) for details.
+
+**Hardware:**
+- **NVIDIA** via `nvidia-smi`, including unified-memory systems like the DGX Spark.
+- **AMD** via `rocm-smi`.
+- **Apple Silicon** via `ioreg`.
+- **CPU-only.**
+
+## Running it for real
+
+    lonoboard install --now          # a systemd user service running `lonoboard serve`
+
+The board listens on **localhost only** until you say otherwise. To reach it from elsewhere:
+
+- **Tailscale** (recommended). Keep it on localhost and publish it with `tailscale serve`. lonoboard
+  then finds the other machines on your tailnet for the fleet screen.
+- **Your LAN.** Set `listen` and a `password`. lonoboard won't listen beyond localhost or your
+  tailnet without one. The password is asked for at a login prompt in the terminal, and the
+  API takes it as a bearer token.
+
+[SECURITY.md](https://github.com/ztaylor/lonoboard/blob/main/SECURITY.md) covers what the board shows and how it's protected.
+
+See [docs/deployment.md](https://github.com/ztaylor/lonoboard/blob/main/docs/deployment.md) for systemd, Tailscale, Docker and deploying to
+several machines over SSH, and [docs/public-demo.md](https://github.com/ztaylor/lonoboard/blob/main/docs/public-demo.md) for hosting a public
+demo board.
+
+## Configuration
+
+Nothing needs configuring, but everything can be. Settings go in `~/.config/lonoboard/config.toml`,
+or in a file named by `--config` or `$LONOBOARD_CONFIG`:
+
+```toml
+[board]
+tagline = "the attic box"
+
+[[server]]
+name = "lmstudio"
+url = "http://127.0.0.1:1234"
+kind = "openai"
+```
+
+[examples/config.toml](https://github.com/ztaylor/lonoboard/blob/main/examples/config.toml) lists every setting, and
+[docs/configuration.md](https://github.com/ztaylor/lonoboard/blob/main/docs/configuration.md) explains them.
+
+## JSON API
+
+Anything that doesn't ask for HTML gets JSON:
+
+    curl localhost:7777/              # host, services, other ports, fleet
+    curl localhost:7777/api/usage     # requests per hour, top 10
+
+See [docs/api.md](https://github.com/ztaylor/lonoboard/blob/main/docs/api.md) for every endpoint.
+
+## Credits
+
+- The fonts are `PxPlus_IBM_VGA_8x16` and `PxPlus_IBM_VGA_9x16`, from
+  [The Ultimate Oldschool PC Font Pack](https://int10h.org/oldschool-pc-fonts/) by VileR. They
+  are licensed CC BY-SA 4.0 and bundled, so the board works offline.
+- The look is inspired by the ANSI art groups of the 1990s: ACiD, iCE, Blocktronics and the
+  rest of the 16colo.rs archive.
+
+## License
+
+MIT, see [LICENSE](https://github.com/ztaylor/lonoboard/blob/main/LICENSE). The bundled fonts keep their CC BY-SA 4.0 license.

lonoboard-0.1.0/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "lonoboard"
+description = "A live dashboard for the machines running your AI models, drawn like a 1990s ANSI BBS"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE", "src/lonoboard/static/fonts/LICENSE-CC-BY-SA-4.0.txt"]
+requires-python = ">=3.11"
+dependencies = []
+dynamic = ["version"]
+keywords = ["bbs", "ansi", "ansi-art", "telnet", "llama.cpp", "ollama", "vllm", "llm", "dashboard", "homelab"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Environment :: Web Environment",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Topic :: Terminals :: Telnet",
+    "Topic :: System :: Monitoring",
+]
+
+[project.urls]
+Homepage = "https://github.com/ztaylor/lonoboard"
+Issues = "https://github.com/ztaylor/lonoboard/issues"
+Changelog = "https://github.com/ztaylor/lonoboard/blob/main/CHANGELOG.md"
+
+[project.scripts]
+lonoboard = "lonoboard.cli:main"
+
+[tool.setuptools.dynamic]
+version = { attr = "lonoboard.__version__" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+lonoboard = ["static/*.html", "static/fonts/*"]

lonoboard-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

lonoboard-0.1.0/src/lonoboard/__init__.py

@@ -0,0 +1,3 @@
+"""lonoboard: a live dashboard for the machines running your AI models, drawn like a 1990s ANSI BBS."""
+
+__version__ = "0.1.0"

lonoboard-0.1.0/src/lonoboard/__main__.py

@@ -0,0 +1,3 @@
+from lonoboard.cli import main
+
+main()

lonoboard-0.1.0/src/lonoboard/board/__init__.py

@@ -0,0 +1,2 @@
+"""The board: lonoboard's text-mode application, served over telnet and to the web terminal."""
+from lonoboard.board.session import Board, Session  # noqa: F401