Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ismael-sarmiento/kimera_python/llms.txt

Use this file to discover all available pages before exploring further.

Kimera Core is a collection of battle-tested Python utility components designed to eliminate boilerplate in your projects. It provides consistent, well-tested abstractions for local and remote caching, flexible JSON and binary serialization, MD5 hashing, dynamic module imports, structured logging, and file extraction — all following clean, abstract base class patterns so you can extend or swap implementations as your needs evolve.

Introduction

Understand what Kimera Core provides and when to use each component.

Quickstart

Install the package and write your first working cache and serializer in minutes.

Local Cache

In-memory and thread-local caching engines with TTL and size control.

Remote Cache

Redis and Memcached adapters with a uniform cache interface.

Serializers

Custom JSON serialization for datetime, date, list, tuple, dict, and more.

Utilities

Hash, import, exception, and logging utilities.

What’s inside

1

Install kimera-core

Install from PyPI using pip — requires Python 3.6 or later.
2

Pick a component

Choose from caching engines, serializers, hash utilities, or logging handlers depending on your use case.
3

Integrate and extend

Every component is built on abstract base classes — swap implementations or subclass to fit your architecture.
4

Run the tests

A full unit-test suite (pytest / tox) ships with the library so you can verify correctness after any customization.

Key features

Local Cache

InMemoryCacheEngine and ThreadCacheEngine with configurable TTL and max-size eviction.

Remote Cache

First-class RedisEngine and MemcachedEngine adapters behind a common interface.

KimeraSerializer

Recursive JSON serialization for complex Python objects including datetime and nested collections.

Pickle Wrapper

A thin, consistent Pickle wrapper for binary object serialization and deserialization.

MD5 Hashing

build_hash() generates a deterministic hash from any Python object regardless of type.

Import Utils

ImportUtils provides safe runtime module checks and dynamic attribute loading.

Build docs developers (and LLMs) love