Icarus Core

Shared Python library for all Icarus tools — provides UE4 binary property parsing, serialization, and save file I/O.

Used by icarus/pets, icarus/prospects, and icarus/portal.

Installation

# As an editable dependency (from a sibling project's virtualenv):
pip install -e path/to/icarus-core

# With dev dependencies:
pip install -e "path/to/icarus-core[dev]"

Usage

from icarus_core import BinaryReader, BinaryWriter, parse_properties
from icarus_core import serialize_properties, props_to_binary_array
from icarus_core import load_save, decompress_blob, parse_blob

Package contents

icarus_core/
├── __init__.py          # Public API re-exports
├── ue4_parser.py        # BinaryReader/Writer + recursive property parser
├── ue4_serializer.py    # Property tree → binary serializer
└── save_io.py           # JSON load/save, blob compress/decompress, actor helpers

Running tests

pip install -e ".[dev]"
pytest tests/ -v

License

GPL v3 — Copyright © 2026 David Beauchamp