---
id: passagemath-objects
version: "10.8.9"
license: GPL-2.0-or-later
license_treatment: copyleft
maintenance: active
---

# passagemath-objects — passagemath: Sage objects, elements, parents, categories, coercion, metaclasses

License: copyleft · Maintenance: active · Downloads: 77.8K/mo

## What it is and what it does

passagemath-objects is a modularized subset of mathematical software, extracted and distributed as a standalone pip-installable package. It provides foundational object-oriented infrastructure: the element/parent framework for representing mathematical objects, the category system for organizing mathematical structures, the coercion machinery for automatic type conversion, and the metaclasses that power the type hierarchy. This package is part of the passagemath fork, created in October 2024 to bring mathematical software into closer alignment with the scientific Python ecosystem while maintaining GPL-2.0-or-later licensing.

The package is intended for developers who need this object model without installing a full distribution. It depends on gmpy2 (arbitrary-precision arithmetic), cysignals (signal handling for interrupts), and typing_extensions for runtime type hints. Binary wheels are available for macOS, Linux (including musl), and Windows x86_64, though full Windows support still requires WSL or virtualization. The package is actively maintained with support for Python 3.11 through 3.14.

Use it for:

- Building mathematical libraries that need the element/parent framework and coercion system without a full distribution.
- Integrating mathematical objects into scientific Python workflows using gmpy2 and other ecosystem packages.
- Developing educational software that leverages the category system and mathematical object hierarchy.
- Creating domain-specific mathematical abstractions that inherit from the provided base classes and metaclasses.
- Prototyping mathematical algorithms using the type coercion and dispatch mechanisms.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a foundational object system, element/parent framework, categories, and coercion machinery as a standalone, pip-installable Python library.

Yes, if you need this object system and coercion framework in lightweight, modular form. The package is actively maintained with no known vulnerabilities and offers binary wheels for major platforms. The GPL-2.0-or-later copyleft license is a hard constraint for proprietary projects; for open-source and academic use, it is straightforward. Install friction is moderate due to compiled dependencies, but pre-built wheels reduce friction on standard platforms.

## Install

pip install passagemath-objects
uv add passagemath-objects
poetry add passagemath-objects

## Installing passagemath-objects

Before you install: Medium install friction due to compiled dependencies (gmpy2, cysignals) requiring system libraries when building from source. Actively maintained with recent releases; last commit 2026-08-14. Supports Python 3.11–3.14.

License in practice: GPL-2.0-or-later copyleft license requires derivative works to be open-source under compatible terms; suitable for academic and open-source projects but requires legal review for proprietary use.

Quickstart:

pip install passagemath-objects

from passagemath_objects.structure.element import Element
from passagemath_objects.structure.parent import Parent

Requires Python 3.11–3.14; gmpy2 and cysignals dependencies may require system libraries (gmp, mpfr, mpc) when building from source.

Verify before relying:

- Whether the coercion system and metaclass framework are stable for production use outside their original context.
- Performance characteristics and memory footprint of the extracted subset.
- Compatibility guarantees with upstream projects and versioning stability.

## Package facts

- License: GPL-2.0-or-later (copyleft)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 77.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

element parent framework python, mathematical object coercion system, categories metaclasses mathematics, python mathematical software objects, modular mathematical library pip, mathematical-objects, coercion-system, modular-subset

[View on SkillFed](https://skillfed.io/packages/passagemath-objects) · [View on PyPI](https://pypi.org/project/passagemath-objects/)