Repository navigation
PlantCraft 0.5.1
PlantCraft 0.5.1 (2026-10-30)
Maintenance release after the 0.5.0 launch: new look, the plantcraft name everywhere, a clear contribution path, faster Historian reads, bounded View memory and a working install on macOS with Docker Desktop. No new apps.
Changed
- New look: the PC valve logo and Steel Blue. The mark is now the
letters P and C drawn as a control valve on a process line; the brand colour moves from
#0A66D0to Steel Blue#2E5A88(#3D78B6on dark), across buttons, links, selection, focus
and the sidebar accent. App tiles keep their hues, toned toward the new blue, with dark values
that hold on black. New app marks: Analytics (two connected blocks), Models (a distillation
column), Desk (console with the day's checklist), Alarms (a bell without the limit line),
Historian (the data cylinder without the time axis), Documents (a page without the
magnifier). The family image no longer shows the plant simulator, which is not an app. New
brand/folder with PNG logos and the LinkedIn avatar and banner.
Added
-
"Talk to us" in the public demo. A visit shows a small button at the bottom right on every
page, the apps included, that opens the site's contact form in a new tab
(PLANTCRAFT_PUBLIC_DEMO_CONTACT_URL, an https address;deploy/cloud/vm.shpoints it at
plantcraft.io/#talk, which opens the form at once). The page after a visit ends offers it
too. Without the setting nothing shows. -
The public demo starts the same for every visitor. A visit starts
with the newest 20 notifications unread and the rest read, whatever the live plant added, and
the seed leaves the newest message of 4 conversations unread (the Messages badge shows 4).
Opening a conversation is now the visit's own read mark, like every other mark since the
check and favorites: before, it marked the shared demo account, so the next visitor found
everything read. -
Tables and pages on a phone (fine pass 2026-10-28, ui 0.86.0). A table column can be left
out on a phone (DataColumn.phone: "hide"), cells are tighter there, a number and its unit
never split, and a header actions cell keeps the header's rule. Overview widgets stacked on a
phone are as tall as what they show (no empty desktop row under a short list;CardGrid
phoneHeight). Page tabs that scroll sideways fade at the edge with more tabs and keep the
active one in view. System health and Backups leave their secondary columns out on a phone; a
state, a size and a backup's name stay on one line. -
Check, seen or not, favorites. A notification gets a check (done) in its
row, in the quick-access panel, when it is open and on the page it opens (a small bar on the
action or the alarm); one button turns it seen and not seen again. A conversation and an
assistant chat can be marked unread until opened; the three take a star, favorites first.
PUT /api/me/marks. On the public demo each visit marks for itself only.
Changed
-
The platform's Python package is
plantcraft. The folder at the root of
the repository, every import andpython -m plantcraft.<module>follow the product's name, and
the distribution isplantcraft.processcraftstill runs: the console script, and inside the
imagespython -m processcraft.<module>(plantcraft/legacy.py), so an olderinstall.sh, a
rollback to 0.5.0 and the Backups page keep driving every version's installer image. Image and
service names, data folders, the app id, cookies and stored ids are unchanged. -
Contributing is one clear path. The README leads with how the suite fits together and how
to contribute (commands moved todocs/development.md). Issue forms for a bug, an idea, a
question and a change to the core;.github/labels.ymlis the label set a workflow keeps on the
repository;docs/maintainers.mdis how issues and pull requests are answered, and a Claude
Code skill (.claude/skills/review-contribution) checks whether a pull request fits. The
agent rules and module pages are written for any contributor: no dated notes, no internal
codes, and STATUS and devlog pages start fresh (the CHANGELOG is the record). -
Analytics says what it is: scheduled monitors, diagnostics and KPIs for signals and control
loops, in its card, the guides and the site. The name stays. -
Turn the assistant on in four steps.
docs/assistant.mdopens with them (it is off until an
administrator connects a model), linked from the README and the install guide; the public
demo's assistant says so too. -
Architecture in pictures and the zones of a contribution.
docs/architecture.mdopens with
the suite in one diagram, how the apps talk (one sticky valve) and what is core and what is open;
CONTRIBUTING.mdsays when an issue comes first. The Zones check (dev/pr-zones) shows a pull
request's zones on its run page and holds a fork's core change to an agreed issue.
Fixed
-
The Historian answers raw reads about four times faster. Writing the time of every value
one by one was 79 % of a raw read of millisecond samples (a day of the demo's 167 plant
signals: 3.1 s, now 0.85 s).plantcraft-sdkwrites sub-second times for a whole series at
once, with the same text as before. With ten methods reading at once, Analytics' round went
from 30 to 16 s. -
A new install on macOS or Windows starts. On a Docker Desktop bind mount several
PlantCraft processes wrote a new database at once and corrupted it ("database disk image is
malformed"): file locks do not hold between processes there. PlantCraft now runs one process
wherever SQLite cannot use WAL, whateverPLANTCRAFT_WORKERSsays. Building a release works
withpython3only (macOS) in every app's Makefile too. -
View no longer runs out of memory with many viewers. Its short cache kept expired
diagram data until it held 4,096 entries; on the public demo View reached its 2 GiB limit and
was stopped (2026-10-29). Expired data now leaves at once, and viewers asking for the same
data together share one read. -
The old name is gone from what people type and download. The command
isplantcraft(processcraftstill works), release files are
plantcraft-<version>-linux-<arch>-bundle.tar.gz,ssh-keygenchecks them as
release@plantcraft(same key; a signature does not carry the name), the update page names
every app with its current name (Analytics, View, Historian, Simulator) and the user guides say
Analytics and View where they still said Link and Dashboards. The site's chat knows the former
names. The Python package, images, services and data ids keepprocesscraft, so installations
and their data do not change. -
Running from source says which Python to use (#10). The demo from source is tested on
Python 3.12 and 3.13, and on 3.15 asyncua, the OPC UA library, fails to read, so signals show
no values. The README and the install guide now say 3.12 or 3.13 (the Simulator needs 3.12),
andrun_opcua_demo.pywarns on a newer Python. Thanks to the reporter of #10. -
Analytics rounds no longer fail with "PlantCraft could not be reached: timed out" (demo,
2026-10-29, SDK 0.78.0). A loop round reads a day of every loop's signals; while the
Historian served other long reads, the round's read waited its turn in the Historian's read
budget (up to 30 s) longer than the SDK client's 15 s, so the client asked again while its
first read still ran, three times, and the round failed (22 times in 8 h on the demo, "failed"
in the Queue). The SDK's series reads now wait 90 s (SERIES_TIMEOUT, other calls keep 15 s)
and PlantCraft waits 75 s for the Historian (HISTCRAFT_TIMEOUT_SECONDS, was 40 s), longer
than the budget wait plus the Historian's own 30 s read limit. -
Public demo, found by testing it online (2026-10-27). The maintenance and manager guides
opened "Report not found": the demo's visitor joins the Instrumentation and control group,
which View's Control loops folder is shown to. The demo's four calculated signals are made
again (their formulas named the Simulator's tags withoutCPM.Loops.). The visit's clock sits
at the bottom (it covered Desk's greeting, and on a phone the tour's buttons); the guide's
card no longer overflows with a long role name. An IPv6 visitor's places are counted by its
/64, not by each device. Desk's Unread messages shows a reference by its name, not
#[name](action:9). -
The site's chat gives OpenAI's reasoning models room to think (empty answers came back as
"cannot answer right now"), asks once more when the model fails, logs why, and answers
Portuguese in Brazilian Portuguese.
Downloads
| Bundle | For | Size | SHA-256 |
|---|---|---|---|
plantcraft-0.5.1-linux-amd64-bundle.tar.gz |
most servers | 2,028,246,573 bytes (1.9 GiB) | 23a020279a8fdbed35441626e412750663405f23bdee0ea955ed800b52586ba4 |
plantcraft-0.5.1-linux-arm64-bundle.tar.gz |
ARM servers and Apple silicon | 1,977,122,823 bytes (1.8 GiB) | 63c5eab031cce434ada7d69826c183678c8abe02dd51822161e26b788ce587ca |
Each bundle comes with its .sha256 and .sha256.sig. docs/install.md explains how to check them with ssh-keygen as release@plantcraft (OpenSSH fingerprint SHA256:9l/yDgR8/Pzel1pncxrXz2IGCIhFirKpDT78tO49fG8).
Upgrading
Run ./install.sh from the new bundle. Data, settings and accounts are kept, and the previous version stays available for rollback (./install.sh --rollback).
Each app's own changes are in its CHANGELOG.md under apps/.