Git Automation
Some of you may have read my Git Battles post, where I talked about how I developed and a documented a Git workflow.
图解的力量
你听过“一图胜千言”这句话吧？在编程领域，我甚至觉得一张图能抵得上一千行代码……
问题所在
这篇文章源自我正在开发的 Db4E 项目，一个用于 Monero 挖矿的部署、运维和实时分析仪表盘。项目原本进展顺利，直到一个奇怪的错误出现：从数据库缓存查询 P2Pool 部署列表时，竟然得到了重复条目。尤其令人困惑的是，列表是通过字典的 values() 方法生成的。理论上不应该出现相同条目，但它们就在那里。
根本原因
深入排查后，我意识到应用里居然存在两个（甚至更多？）数据库缓存对象的副本。我没有集中管理缓存的所有权，于是系统的不同部分各自创建了缓存实例。
重构代码
我开始清理和重构：移动类的位置、传递对象引用、调整构造函数参数。但事情很快变得混乱，我不断迷失方向，不得不反复推倒重来。
项目当时有 32 个类，因此这件事并非微不足道。又把代码弄乱一次后，我决定离开键盘思考一下。事实上，我走得有点远：绕着街区散了个步，认真想了想。
解决方案：画图
我发现自己真正需要的是一张类图，清楚展示各个类之间的关系。只要能看出某个类是包含在另一个类里，还是仅仅传递了一个引用，就够了。
有了这张蓝图，后续实现就简单多了。
结论
图片确实胜过千言。如果你盯着代码看得头昏脑涨，不妨试着画张图。它就像一份蓝图！
后记：Draw.io
我用的是免费的浏览器工具 Draw.io 来画图。强烈推荐，它有这些特点：
- 免费
- 内置版本控制
- 可以保存到各种位置，包括 Google Drive
- 支持导出多种格式
如果你也在项目里卡住了，试着画出来吧。有时候，穿越一团乱麻般的代码，最短的路就是一支笔和一张图。
2026
My blog in Simplified Chinese
I recently built MyCount to track website visitors to my projects. I found that that over 40% of my visitors were from China, and that 35% of those used a Ch...
MyCount: Website Analytics & Marketing
I have a future project in mind which will require a Dynamic DNS service. I created BMDynIP for that purpose. After building the service, I wanted a simple a...
DiskHA - Disk Replication, Health Checks, and Email Alerting
I run an NFS server on my network. I use two large drives and a cron job to rsync the data to provide basic data protection. This solution will not save you ...
Animating Ax3l Playing Snake
I’ve been tinkering with various incarnations of Patrick Loeber’s Train an AI to Play Snake tutorial for a while now. It’s my relaxing goto project that’s fu...
Dynamic DNS Service
This project started as a cron job and a flatfile and -honestly- that would work perfectly well for a small home setup. Say, two or three machines. I’m curre...
Local GeoIP Database
The Bear & Moose GeoIP Project provides an easy-to-use GeoIP service for your applications and for interactive lookups.
An LLM to organize my Movies
Our first TV was a small black-and-white thing where, on rare occasions, we’d watch Animal Kingdom. Then Beta and VHS came along, and you could watch them at...
From Prototype to Product (4/4)
Fr3d worked: It could talk to the Snake Lab, propose changes to the RNN configuration, run experiments, look at the results, and try again. It proved the ide...
Prompt Engineering 101 (3/4)
The Snake Lab had become a proper server, with a ZeroMQ API, configuration validation, a database, and a way to run experiments independently of the client. ...
The Evolution of Snake Lab (2/4)
In my last post, I setup a locally hosted LLM running on an old HP Z440 and wrote a crude little conversation loop. I generated random numbers, fed them to t...
Local LLM Writes Haikus (1/4)
This is part one of a four part blog series. In this post, I download, install and setup some software to prompt a local LLM to write haikus…
From Seed to Signal: AI FX
In the first post, AI FX was still mostly a seed: a repo, a PyPI package, and an idea about using automated FOREX tooling as a learning lab. Since then, the ...
Simulating the Power Grid
A potential client pointed me to Empowering the Energy Transition Through Fast and Flexible Network Simulation. The article describes an Open Source project,...
Delphi in a Day
I have a prospective client who runs a small group of technology businesses, at least one of which integrates with clients using the Delphi programming lan...
A Small Experiment: AI FX
I’ve spent some time around trading systemsL At Merrill Lynch, I supported the Order Audit Trail System (OATS), a compliance system required by NASDAQ. Its p...
A Rosebud from the Guppies
A Rosebud, a Few Guppies, and a Quiet Little Ecosystem
2025
My Art on Etsy
I setup an Etsy Storefront to sell high quality, museum grade prints of some of my artwork.
Python systemctl Wrapper
I’ve been working on Db4E, my Monero deployment, operations and analytics platform. It uses Linux systemd to spin up manage Monero, P2Pool and XMRig instance...
AI Snake Lab
AI Snake Lab is an interactive reinforcement learning sandbox for experimenting with AI agents in a classic Snake Game environment — featuring a live Textual...
The Power of Pictures
You know that saying, “A picture is worth a thousand words.”? In programming, I’d argue it can be worth a thousand lines of code…
Caring About Constants
This post is about using constants in your code. Why it matters, what the benefits are and how you can do it well. I’m sad to say, I learned this the hard wa...
Where’d They Go? Welcoming 17 Racoon Tiger Shrimp to the Tank
This week, I introduced 15 raccoon tiger shrimp—plus a surprise 2 bonus—to my aquarium. After a proper acclimatization, I released them into the tank… and ju...
Why I Built Db4E
When I first started experimenting with Monero mining and self-hosted infrastructure, I did what everyone else does: I downloaded the Monero software, the P2...
Releasing with Git
Let me be honest: Git has punched me in the face more times than I can count. Every time I think I’ve got a smooth release flow down, Git yells, “Not so fast...
Documentation Matters
I was burned by opaque documentation: I’ve been building a modern terminal UI in Python using the excellent Textual framework. It’s sharp, fast, and honestly...
Textual Replaces ApexCharts
The original reporting system was a set of static dashboards built using GitHub Pages, JavaScript, and ApexCharts. It pulled data from my mining setup — via ...
Pivot to Textual
I’ve been deep in the trenches with my Db4E project — pulling together Monero mining infrastructure, MongoDB integration, and a bunch of orchestration magic....
Released Db4E SystemD
I recently published a small Python module to PyPI and GitHub: db4e-systemd, a lightweight wrapper around systemctl that lets you control services (start, st...
NIKU Farms
I received my order from NIKU Farms, YAY! It’s a meat delivery that my sister, Corinna Ghaznavi, gifted me this Christmas. Every two months I receive this am...
The Main Website
As part of my goal to be more visible in the world, I setup this domain i.e. https://osoyalce.com. I use it to publish information about the projects I’m wor...
Reviving the Blog
It’s been a while since I started and then abandoned this blog. My last post was in June of 2024!!
Changing the Blog Site’s Layout
I decided that I didn’t like the way that the main blog page looks. I am using GitHub to host the website and am using a fork of the jekyll/minima theme. My ...
2024
Aquaponics Update #1
It’s in the construction phase. I need to complete the water circulation process. I bought a fiber glass kit for this (and also to fix my kitchen sink!).
What I’m working on
The XMR Mining Farm complete with this eye-popping chart The Bear and Moose Knowledge Base My resume MyZODB - A Place to Store Everything