styro

The package manager for OpenFOAM

Simplify your OpenFOAM workflows with easy package installation, management, and distribution

OpenFOAM

✨ Why styro?

styro brings modern package management to the OpenFOAM ecosystem, making it easy to discover, install, and manage community-contributed packages. Whether you're a researcher, engineer, and/or developer, styro streamlines your workflow by eliminating manual compilation and dependency management.

🎯 Key benefits

🚀 One-command installation - Install OpenFOAM packages with a single command
🌎 Community-driven - Access packages from the OpenFOAM Package Index (OPI)
🧩 Broad compatibility - Works seamlessly with OpenFOAM from openfoam.com and openfoam.org
📦 Multiple sources - Install from OPI, local directories, or Git repositories
🔄 Easy updates - Upgrade packages with automatic dependency resolution
🛠️ Developer-friendly - Simple package testing, definition and distribution

▶️ Demo

Demo

📋 Requirements

Before using styro, ensure you have:

OpenFOAM (from openfoam.com or openfoam.org)
Git

⏬ Installation

Choose any of the following methods:

With pip (requires Python 3.9 or later):
```
pip install styro
```
With conda:
```
conda install -c conda-forge styro
```
With Homebrew:
```
brew install gerlero/openfoam/styro
```

Standalone binary (installs to $FOAM_USER_APPBIN):

/bin/bash -c "$(curl https://raw.githubusercontent.com/gerlero/styro/main/install.sh)"

Docker image:
```
docker pull microfluidica/styro
```

🧑‍💻 Command reference

Command	Description	Example
⏬ `styro install <packages>`	Install one or more packages	`styro install cfmesh`
⬆️ `styro install --upgrade <packages>`	Upgrade already installed packages	`styro install --upgrade cfmesh`
🗑️ `styro uninstall <packages>`	Remove installed packages	`styro uninstall cfmesh`
🔍 `styro freeze`	List all installed packages	`styro freeze`
🔄 `styro install --upgrade styro`	Upgrade styro itself (only for standalone installs)	`styro install --upgrade styro`

📦 Package sources

✨ OpenFOAM Package Index (OPI)

styro automatically discovers packages from the community-maintained OpenFOAM Package Index.

styro install cfmesh

🖥️ Local packages

Install packages from your local filesystem:

styro install /path/to/my-custom-package

Pro tip: Add a metadata.json file to the package directory to customize installation behavior.

🌎 Git repositories

Install directly from any Git repository:

styro install https://github.com/username/my-openfoam-package.git

Just like local packages, add a metadata.json file to the repository root for custom installation settings.

🤝 Contributing

We welcome contributions! Here's how you can help:

📦 Add packages to the OpenFOAM Package Index
🐛 Report bugs or request features via GitHub Issues
🔧 Submit pull requests to improve styro itself

Metadata

Release files for styro 0.1.35

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for styro 0.1.35
File	Size	Uploaded
styro-0.1.35.tar.gz	27.1 kB	Sep 3, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for styro 0.1.35
File	Interpreter	ABI	Platform	Reset
styro-0.1.35-py3-none-any.whl 29.2 kB Sep 3, 2026	Python 3	none	any	Details

Total release size: 56.2 kB

Release files / styro-0.1.35.tar.gz

Download URL	styro-0.1.35.tar.gz
Size	27.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`b0574ff6f7a049abe2eabc19df19fad783d73a7a9dc50f85102acd5f3e916d89`
BLAKE2b-256 checksum How to use checksums	`b782bba21cd94c16f64df8fb85caa7fd8dfd6c7b99e89a4556a67a1f50a9fa9f`
Upload date	Sep 3, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / styro-0.1.35-py3-none-any.whl

Download URL	styro-0.1.35-py3-none-any.whl
Size	29.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ea8365cdfb7c4ef4fb9ee25424e043e54be5f8dca270009240ca222f199c34ff`
BLAKE2b-256 checksum How to use checksums	`5fca5ddc61b7610768af42f145c6dbeda6cf4c36b31904ff1eebfb71bd196a85`
Upload date	Sep 3, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`