babylonian-image-library ^v1.0.1

Current Version: 1.0.1 (New Modular Architecture)

Complete rewrite with breaking changes — this version introduces a completely new architecture inspired by the Smart Babylon Library:

• Multi-Universe Support — Isolated image libraries with different configurations
• 6D Coordinate System — Floor, room, cabinet, shelf, book, page coordinates
• Deterministic Generation — Same coordinates always produce the same image
• Home Directory Storage — Organized storage in ~/babylonian_image_library/
• Multiple Image Types — Standard and abstract image generation
• Configurable Settings — Custom dimensions, formats, and quality
• Modular Architecture — Clean separation with config, coordinates, core, and generator modules

Legacy Version: 0.1.4 (Deprecated)

Version 0.1.4 and earlier are no longer supported. The previous monolithic architecture has been completely replaced by the new modular system.

This library implements concepts from our published research:

• Pointer-Based Security Paradigm — Architectural shift from data protection to data non-existence
• Local Data Regeneration Paradigm — Ontological shift from data transmission to synchronous state discovery
• Deterministic Game Engine — Practical implementation validating the theoretical paradigms
• Position-Candidate-Hypothesis (PCH) Paradigm — A New Research Direction for NP-Complete Problems

• Deterministic Image Generation — Same coordinates always produce the same image
• Infinite Image Library — Virtually unlimited images through coordinate system
• Zero Image Storage — Images generated on-demand, only metadata stored
• Multi-Universe Support — Isolated libraries with different configurations
• Home Directory Storage — Automatic organization in user's home directory
• Configurable — Custom image dimensions, formats, and quality
• Abstract Art Generation — Algorithmic abstract image creation
• Modular Design — Clean, maintainable architecture

pip install babylonian-image-library

from babylonian_image_library import SmartBabylonImageLibrary

# Create library instance
library = SmartBabylonImageLibrary()

# Generate a random image
image_path = library.generate_random_image()
print(f"Image saved: {image_path}")

# Get specific image by coordinates
image = library.get_image(floor=1, room=3, cabinet=2, shelf=5, book=42, page=1)
image.save("specific_image.png")

The library follows a modular architecture:

babylonian_image_library/
├── library/
│   ├── config.py      # ImageLibraryConfig
│   ├── coordinates.py # ImageCoordinates
│   ├── core.py        # BabylonianImageLibrary, SmartBabylonImageLibrary
│   └── generator.py   # BabylonianImageGenerator

Each image is located using 6-dimensional coordinates:

• floor — Library floor (0-100)
• room — Room number (0-50)
• cabinet — Cabinet number (0-20)
• shelf — Shelf number (0-10)
• book — Book number (0-1000)
• page — Page number (0-500)

from babylonian_image_library import SmartBabylonImageLibrary, ImageLibraryConfig

# Custom configuration
config = ImageLibraryConfig(
    universe="abstract_art",    # Universe name
    width=800,                  # Image width
    height=600,                 # Image height
    image_format="JPEG",        # PNG, JPEG, etc.
    quality=90                  # JPEG quality (1-100)
)

library = SmartBabylonImageLibrary(config)

from babylonian_image_library import SmartBabylonImageLibrary, ImageLibraryConfig

# Different universes - different images
fantasy_config = ImageLibraryConfig(universe="middle_earth")
scifi_config = ImageLibraryConfig(universe="andromeda_galaxy")

fantasy_library = SmartBabylonImageLibrary(fantasy_config)
scifi_library = SmartBabylonImageLibrary(scifi_config)

# Same coordinates, different images
fantasy_image = fantasy_library.get_image(1, 1, 1, 1, 1, 1)
scifi_image = scifi_library.get_image(1, 1, 1, 1, 1, 1)

SmartBabylonImageLibrary:

• get_image(floor, room, cabinet, shelf, book, page) — Get image by coordinates
• get_abstract_image(floor, room, cabinet, shelf, book, page) — Get abstract image
• save_image(floor, room, cabinet, shelf, book, page, filename) — Save image to file
• save_abstract_image(floor, room, cabinet, shelf, book, page, filename) — Save abstract image
• generate_random_image() — Generate and save random image
• get_library_info() — Get library information

ImageLibraryConfig:

• universe — Universe name (default: "default")
• width — Image width (default: 1920)
• height — Image height (default: 1080)
• image_format — Image format (default: "PNG")
• quality — JPEG quality (default: 95)

ImageCoordinates:

• floor, room, cabinet, shelf, book, page — Coordinate components
• seed — Combined seed string for generation
• to_dict() — Convert to dictionary
• to_json() — Convert to JSON string

Before (0.1.4):

from babylonian_image_library import BabylonianImageLibrary

library = BabylonianImageLibrary()
address = library.generate_random_address()  # "Room42:Wall3:Shelf7:Volume5:Book23:Page456"
library.save_image(address, "image.png")

After (1.0.1):

from babylonian_image_library import SmartBabylonImageLibrary

library = SmartBabylonImageLibrary()
image_path = library.generate_random_image()  # Automatically generates coordinates
# Or use specific coordinates:
image = library.get_image(floor=1, room=3, cabinet=2, shelf=5, book=42, page=1)

Key breaking changes:

• New import paths: from babylonian_image_library import SmartBabylonImageLibrary
• Different coordinate system: 6D coordinates instead of address strings
• Modular structure with separate config, coordinates, core, and generator modules
• Multi-universe support with isolated libraries
• Home directory storage: ~/babylonian_image_library/

Images are automatically stored in:

• Linux/Mac: ~/babylonian_image_library/{universe}/
• Windows: C:\Users\{username}\babylonian_image_library\{universe}\

Image generation is deterministic based on coordinates and universe:

# Same coordinates = same image
library1 = SmartBabylonImageLibrary(ImageLibraryConfig(universe="test"))
library2 = SmartBabylonImageLibrary(ImageLibraryConfig(universe="test"))

image1 = library1.get_image(1, 1, 1, 1, 1, 1)
image2 = library2.get_image(1, 1, 1, 1, 1, 1)

# Images will be identical

RESEARCH STATUS: This implementation is part of ongoing research into deterministic systems and pointer-based architectures. It should not be used in production environments or for any critical applications.

Basic Usage:

from babylonian_image_library import SmartBabylonImageLibrary

library = SmartBabylonImageLibrary()

# Generate multiple random images
for i in range(5):
    path = library.generate_random_image()
    print(f"Generated: {path}")

# Get library information
info = library.get_library_info()
print(f"Library location: {info['library_path']}")
print(f"Total images: {info['total_images']}")

Working with Coordinates:

from babylonian_image_library import ImageCoordinates

# Create specific coordinates
coords = ImageCoordinates(floor=5, room=10, cabinet=3, shelf=2, book=150, page=42)
print(f"Coordinates: {coords}")
print(f"Seed: {coords.seed}")

# Use coordinates with library
image = library.get_image(coords.floor, coords.room, coords.cabinet,
                         coords.shelf, coords.book, coords.page)

Advanced Usage:

from babylonian_image_library import SmartBabylonImageLibrary, ImageLibraryConfig

# Create specialized universe for digital art
art_config = ImageLibraryConfig(
    universe="digital_art",
    width=1024,
    height=768,
    image_format="PNG"
)

art_library = SmartBabylonImageLibrary(art_config)

# Generate a series of abstract artworks
for i in range(10):
    art_library.save_abstract_image(1, 1, 1, 1, i, 0, f"artwork_{i}.png")

By using this software, you agree to the full disclaimer terms.

Software provided "AS IS" without warranty. You assume all risks.

Full legal disclaimer: See DISCLAIMER.md

License: BSD 3-Clause License