Skip to content

BitlaForge v0.1.0 - Pivot to Textual TUI (Forge era)

Choose a tag to compare

View all tags
@jetomev jetomev released this 29 May 00:16
v0.1.0
998e018

BitlaForge v0.1.0 — Pivot from Qt6/Widgets to Textual TUI; first Forge-era release.

This repo used to be BitLA, a Qt6/Widgets desktop scaffold pushed in November 2025 with simulation-driven UI and no real minerd integration. Untouched for ~6 months. On 2026-05-28 it pivoted to a Textual TUI under the KognogOS Forge suite — solo Bitcoin mining is fundamentally a streaming-stdout activity on long-running headless rigs, which a TUI fits better than a Qt GUI (it runs cleanly over SSH; the same audience that runs solo miners is the audience that loves TUIs).

The Qt prototype is preserved permanently as the v0.1.0-qt-archived git tag. main is the Textual TUI from this point on.

What ships in v0.1.0

A Forge-style TUI skeleton, built on patterns proven in grubForge v1.0.3 and alacrittyForge v0.1.1:

  • Three screens — Dashboard (read-only miner overview), Log (streaming view with 5,000-line bounded buffer + search filter + auto-scroll), Config (pool / wallet / algorithm / threads).
  • Sidebar nav + ContentSwitcher routing, with refresh-on-show via a silent on_show hook and DEFAULT_FOCUS so screen bindings fire on the first keypress without a panel click.
  • StatusMixin for unified status-line + toast feedback, with popup=False for passive mount hints so the app launches quietly.
  • Toggleable HelpScreen modal (Esc / q / ? all dismiss; q shadows app-quit while help is up).
  • ConfirmDialog with escape → cancel, enter → confirm.
  • Catppuccin Mocha styling, consistent with the rest of the Forge suite.

What does NOT yet work

Real minerd integration is not wired. Dashboard fields show placeholders, the log buffer is empty, the M key just flips a state flag and notifies. Wiring asyncio.create_subprocess_exec to spawn minerd, parse its stdout, and stream into the Log screen is the headline work for the next cycle (v0.1.1).

Roadmap

  • v0.1.1 — minerd subprocess (spawn / parse / stop); real Dashboard fields; log streaming.
  • v0.1.2 — Config persistence (~/.config/bitlaforge/config.toml); start-miner pre-flight; error handling.
  • v0.1.3 — Forge release machinery: testing/ + Test Matrix, man page, PKGBUILD with hardened headless-mount check(), first AUR submission.

Install (v0.1.0)

sudo pacman -S python-textual python-rich
git clone https://github.com/jetomev/bitlaforge.git
cd bitlaforge
python main.py

AUR submission lands with v0.1.3, once there's real behavior to verify.

Co-developed by Javier (@jetomev) and Claude (Anthropic). Same recognition thesis as the rest of the Forge suite — public projects demonstrating AI as a serious software collaborator.

Assets 2
Loading