The Open Standard for
Mycological Data
WeMush Open Labeling Standard (WOLS) is an open-source specification for encoding cultivation data in machine-readable QR codes. Traceable, interoperable, and free forever.
The Problem: Data Silos
Mushroom cultivation is plagued by proprietary formats. Data from one system cannot be read by another, breaking the chain of custody and traceability.
Vendor Lock-in
Cultivators are stuck using single-vendor ecosystems that do not talk to each other.
Unverifiable Research
Without standardized data, experiments cannot be easily reproduced or verified by peers.
Opaque Supply Chains
Consumers have no way to verify the origin, substrate, or sustainability of their food.
The Solution: WOLS
A universal language for mushroom cultivation. Encode compliant, detail-rich data into standard QR codes.
Vendor-agnostic data exchange. A label printed by WeMush software can be read by any WOLS-compliant scanner or app.
Support for both public transparency and encrypted proprietary data. You control what you share.
{
"@context": "https://wemush.com/wols/v1",
"@type": "Specimen",
"id": "wemush:clx1a2b3c4",
"version": "1.2.0",
"type": "SUBSTRATE",
"species": "Pleurotus ostreatus",
"strain": {
"name": "Blue Oyster",
"generation": "F2",
"clonalGeneration": 3
},
"stage": "COLONIZATION",
"created": "2026-01-04T10:30:00Z",
"batch": "batch_2026_01_001",
"organization": "org_mushoh",
"_meta": {
"parentId": "wemush:clx9z8y7x6",
"platform": "wemush"
}
}Developer Friendly
Easy to implement in any language. Open source libraries available.
import { createSpecimen, toQRCodeDataURL } from '@wemush/wols';
const specimen = createSpecimen({
type: 'CULTURE',
species: 'Hericium erinaceus',
strain: {
name: 'Lion's Pride',
generation: 'F1',
},
stage: 'INOCULATION'
});
// Generate QR code as data URL
const qrUrl = await toQRCodeDataURL(specimen);
console.log(specimen.id); // e.g. wemush:01ARZ3NDEKTSV4RRFFQ69G5FAVfrom wols import parse_specimen
def on_scan(qr_data: str):
result = parse_specimen(qr_data)
if result.success:
specimen = result.data
print(f"Species: {specimen.species}")
print(f"Strain: {specimen.strain.name}")
print(f"Stage: {specimen.stage}")Get Started
Install the official SDK in seconds. Available for TypeScript, Python, and as a container image.
CLI / Container
docker pull ghcr.io/wemush/specimen-labels-pyRun anywhere with Docker or Podman
CLI Usage
# Create a specimen label $ wols create --species "Pleurotus ostreatus" --type SUBSTRATE --json # Validate an existing label $ wols validate label.json # Generate QR code image $ wols qr specimen.json --output label.png --size 300
Open vs. Proprietary
| Feature | WeMush Open Standard | Proprietary Systems |
|---|---|---|
| Cost | Free & Open Source | Expensive Licensing |
| Data Ownership | You own your data | Vendor owns your data |
| Interoperability | Universal (Any App) | Locked Silo |
| Customization | Extensible Namespaces | Fixed Fields |
Built for Everyone
Home Cultivators
Track success rates of different recipes. Share genetics with friends.
Commercial Farms
Automate compliance reporting and track efficiency at scale.
Researchers
Publish verifiable data alongside papers for perfect reproducibility.
Equipment Makers
Build smart autoclaves and flow hoods that auto-log to WOLS labels. Join our Hardware Partner Program.
Frequently Asked Questions
Yes. The specification, schema, and reference implementations are open source under the MIT license. You can use them in commercial or private projects without paying a cent.
No. WOLS is designed for offline-first environments. All critical data is encoded directly in the QR code, so you can scan and verify labels even in a grow room with no signal.
Absolutely. WOLS supports namespaced extensions. You can add custom fields for your specific equipment or processes without breaking compatibility with standard scanners.
WOLS supports optional encryption for sensitive fields. You can choose to make some data public (like species and harvest date) while keeping other data (like exact substrate recipe) encrypted and only readable by authorized devices.
No token. No ICO. No cryptocurrency.WeMush is a software company, not a blockchain project. Our "Digital Notary" feature uses cryptographic timestamps and signatures to verify data integrity and protect IP—similar to how code signing works. This provides immutable audit trails for regulatory compliance without any speculative tokens.
Your data is always yours.Because WOLS is open-source and the libraries are public, your data is safer here than in a closed app. You can export everything at any time. Even if WeMush dissolves, any developer can write a script to read your WOLS QR codes forever. This "exit insurance" is one of our strongest selling points for prudent business owners.