🗂 On PyPI · v0.2.1 · Apache-2.0

Your folders, self-aware.

A tiny convention that tags a directory with machine-readable context — what it is, how critical it is, what it needs. So your configuration travels with the service, not the admin.

pip install folder-nature
Star on GitHub → View on PyPI
Shipped — pip-installable now ✓ 120 tests, CI green ◇ Apache-2.0
The idea

A service that carries its own intent

Every folder in your infrastructure means something — but that meaning lives in the admin's head, in scattered config, or nowhere at all. folder-nature writes it down, right next to the thing it describes, in a small .folder-nature file.

Now tools can read what a directory is for before they touch its contents. Move it to another host and the context moves with it — no rebuilding configuration from scratch.

What it gives you

Small file, large leverage

🧳Portable contextThe description lives with the service. Move between hosts and nothing is lost.
🤖Machine-readableA simple YAML convention. Human-writable, tool-parsable, version-controllable.
🔎Searchable by meaningFind folders by tag, by type, by intent — not just by name.
🔏Signed & self-validatingv0.2 adds cryptographic signing and one-command verify --root across a whole tree.
Try it — 30 seconds

Python 3.10+, one dependency

pip install folder-nature

folder-nature init . --template workspace --name "my-workspace"
folder-nature show .
folder-nature search . --tag client
folder-nature verify . --root
Shipped, tested, Apache-2.0. 120 tests pass in seconds. v0.2 adds cryptographic signing and one-command self-validation on top of the tagging core. Full source, schema, and templates on GitHub.

Free and open — forever

Install it, star it, ship it. Building a commercial product on top and want it without the open-source obligations? There's a license for that.

Get folder-nature → Commercial license →
Backed by
△Illia Hladkyi
Join them ❤