Tad.Turnkey — brownfield integration kit

Overview

tad.tk is a kit that brings together three essential tools—SCM, RPA, and Monitoring—and lets them work seamlessly inside a single UI: 👉 tad.web

The goal is simple: operate legacy or mixed environments with minimal setup and maximum visibility.

Why These Tools?

1. Assist Core Engineering Tasks

   Tool	Purpose
   Fossil	Version control for code and artifacts, built‑in issue tracking, wiki, and documentation.
   Robot Framework + SikuliX	GUI automation via DSL. Works with any GUI app, including VNC/RDP sessions.
   Prometheus	Monitoring for multi‑process and multi‑server environments, with alerting support.

2. Easy to Use & Deploy

   Fossil and Prometheus are single‑binary tools that run on macOS, Linux, and Windows.
   Robot Framework + SikuliX requires a few more steps, but the kit aims to simplify the setup.

Current tad.tk UI Capabilities

1. Fossil (SCM)

   Start/stop Fossil repository server Add a filesystem directory to version control Commit changes

2. Robot Framework (RPA)

   Start/stop SikuliX server Execute DSL scripts and view reports

3. Prometheus (Monitoring)

   Start/stop Prometheus and proxy server Enable monitoring for Fossil and Robot services

Quick Start

1. macOS with babashka installed

2. Installed tools:

   • Fossil
   • Prometheus
   • Robot Framework + SikuliX

config.edn

{:fossil
 {:base "var/repos"
  :user #or [#env FOSSIL_USER "tad"]
  :pass #or [#env FOSSIL_PASS "tadxxxxxx"]}
 :robot
 {:virtual-env ".venv"
  :sikulix-jar "f/sikulix.jar"
  :code "r/c"
  :arch "r/a"}
 :prom
 {:prm-bin "/opt/homebrew/bin/prometheus"
  :pgw-bin "f/pushgateway"
  :tsdb-pth "/opt/homebrew/var/prometheus"
  :prm-web "127.0.0.1:9090"
  :pgw-web "127.0.0.1:9091"
  :prm-job "prm"
  :pgw-job "pgw"
  }
 }

special steps

1. venv (config.edn :virtual-env)

   in the dir of tad.tk

   $ brew install uv
   ...
   $ brew install [email protected]
   ...
   $ uv venv --python 3.11
   ...
   $ uv pip sync requirements.txt
   ...

   -> new dir .venv

2. d/l sikulixidemacm-2.0.6-20230417.154405.jar and pushgateway

   mkdir f

   copy two files into new dir f

normal steps

1. Download frontend resources

   $ bb dl.bb resources/jsdlv/*.txt
   ... downloading ...	

   This fetches all required JS/CSS assets (≈10 MB) into the w/ directory.

2. Generate Documentation

   $ bb docs
   Reading metadata for post: docs.md
   Writing blog/style.css
   Parsing Markdown for post: docs.md
   Processing markdown for file: c/qb/posts/docs.md
   Caching post to file: .work/prod/docs.md.pre-template.html
   Writing post: blog/docs.html
   Writing page: blog/tags/index.html
   Writing page: blog/tags/docs.html
   Writing page: blog/archive.html
   Writing page: blog/index.html
   Writing Clojure feed blog/planetclojure.xml
   Writing feed blog/atom.xml

   The generated site is placed under blog/.

3. Start the web server

   $ bb serv
   pwd: #object[java.io.File 0x20aa826e /Users/tcc/wa/tad.tk]
   URL: http://127.0.0.1:8888/
   2026-03-31T18:42:29.372+08 t4.local INFO [tad.web.svc:18] - Starting svc on port 8888

   Open the browser at: http://127.0.0.1:8888/

Next

• Transition from SikuliX to Oculix
• Simplify installation and startup
• Add Windows and Linux support
• Expand tad.tk functionality