geode-common

library33.23.0pypypi✓ verified 86d ago

geode-common is the foundational Python module for Geode-solutions' licensed computational geometry and meshing libraries. It provides core utilities, license management, and environment initialization for the entire Geode-solutions ecosystem. It is a wrapper around a C++ library using Pybind11. The current version is 33.21.3, with frequent updates aligning with Geode-solutions' development.

ai-ml data

pip install geode-common

package ↗homepage ↗

INSTALL

IMPORT

SIG · GEODE-COMMON

geode-common

ai-mlpythonv33.23.0

Install

3.0s avg

Import

—

Disk

99MB

Pass rate

4/ 10

Env Coverage4 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v33.23.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✕ build_error

✓ 2.9s

py 3.11

✕ build_error

✓ 3s

py 3.12

✕ build_error

✓ 2.75s

py 3.13

✕ build_error

1/2 runs

py 3.9

✕ build_error

✓ 3.3s

99MB installed

● package 99MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

geode_common

✓ import geode_common

set_license

✓ from geode_common import set_license

initialize_geode_solutions

✓ from geode_common import initialize_geode_solutions

This quickstart demonstrates how to initialize the geode-common module, set an (optional) license key, and prepare the environment for other Geode-solutions modules. The `initialize_geode_solutions()` call is crucial.

import os import geode_common # The Geode-solutions ecosystem typically requires a license key. # It's best practice to provide this via an environment variable. license_key = os.environ.get("GEODE_LICENSE_KEY", "") geode_common.set_license(license_key) # Initialize the Geode-solutions environment, which is mandatory # before using any other Geode-solutions modules. geode_common.initialize_geode_solutions() # You can check the version or other common properties after initialization. print(f"Geode-solutions common module initialized. Version: {geode_common.VERSION}") print(f"Logger enabled: {geode_common.Logger.is_enabled()}") # At this point, you would typically import and use other specific # Geode-solutions modules (e.g., geode_mesh, geode_implicit).

Debug

Known issues

breakinggeode-common has strict Python version requirements. It officially supports Python versions 3.9 through 3.12. Attempting to install or run on unsupported Python versions (e.g., 3.8 or 3.13+) will result in installation failures or runtime errors.

fix

Ensure your Python environment is within the supported range (currently 3.9 <= Python < 3.13). Use a virtual environment to manage Python versions if necessary.

affects: All versions

gotchaCalling `geode_common.initialize_geode_solutions()` is mandatory before using any functionality from `geode-common` or any other Geode-solutions module. Forgetting this step will lead to runtime errors.

fix

Always call `geode_common.initialize_geode_solutions()` early in your application's lifecycle, typically right after importing `geode_common` and setting the license.

affects: All versions

gotchaMost licensed Geode-solutions modules rely on a valid license key set via `geode_common.set_license()`. While `geode-common` itself might function partially without it, subsequent imports or operations from other Geode-solutions modules will fail.

fix

Obtain a valid Geode-solutions license key and pass it to `geode_common.set_license('YOUR_KEY_HERE')` or provide it via the `GEODE_LICENSE_KEY` environment variable.

affects: All versions

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'geode_common'

The geode-common package is not installed in the current Python environment, or the environment is not activated.

fix

Run `pip install geode-common` to install the package. Ensure your virtual environment (if used) is active.

RuntimeError: Geode-solutions has not been initialized. Please call geode_common.initialize_geode_solutions() first.

The required initialization function `geode_common.initialize_geode_solutions()` was not called before attempting to use Geode-solutions functionality.

fix

Add `geode_common.initialize_geode_solutions()` to your code before any other Geode-solutions operations.

RuntimeError: License is not valid.

The provided license key is either missing, expired, or invalid for the Geode-solutions modules being used.

fix

Ensure you have a correct and current license key. Set it using `geode_common.set_license('YOUR_KEY_HERE')` or via the `GEODE_LICENSE_KEY` environment variable.

ERROR: Package 'geode-common' requires Python '>=3.9, <3.13', but you have Python 3.X.

You are attempting to install geode-common on a Python version that is not officially supported.

fix

Switch to a supported Python version (3.9, 3.10, 3.11, or 3.12). Consider using `pyenv` or `conda` to manage multiple Python versions.

Upgrade

Version history

33.23.0latest on PyPI · released Jun 13, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

7 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://pypi.org/project/geode-common/ ↗

homepagehttps://geode-solutions.com ↗