Babylonian Image Library v1.0.1
A deterministic infinite image library generator inspired by Borges' 'The Library of Babel'. Generate unique, deterministic images based on coordinate systems without storing image data.
⚠️ Disclaimer
By using this software, you agree to the full disclaimer terms.
Summary: Software provided "AS IS" without warranty. You assume all risks.
Full legal disclaimer: See DISCLAIMER.md
Project Status: Research & Development
IMPORTANT DISCLAIMER: This project is currently in active research and development phase. It is provided as-is for academic and experimental purposes only. No guarantees of stability, security, or fitness for any particular purpose are provided. Users assume all risks associated with usage.
Version Information
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.
Key breaking changes from 0.1.4 to 1.0.1:
- New import paths:
from babylonian_image_library import SmartBabylonImageLibrary - Different coordinate system: 6D coordinates instead of address strings
- Modular structure: Separate config, coordinates, core, and generator modules
- Multi-universe support: Isolated libraries with different configurations
- Home directory storage: Automatic organization in user's home folder
- Enhanced API: Object-oriented interface with better type safety
Related Research Publications
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
Features
- 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
Installation
pip install babylonian-image-library
Quick Start
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")
Architecture
The library follows a modular architecture:
babylonian_image_library/
├── library/
│ ├── config.py # ImageLibraryConfig
│ ├── coordinates.py # ImageCoordinates
│ ├── core.py # BabylonianImageLibrary, SmartBabylonImageLibrary
│ └── generator.py # BabylonianImageGenerator
Coordinate System
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)
Configuration
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)
Migration Guide from 0.1.4 to 1.0.1
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)
Multi-Universe Support
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)
API Reference
SmartBabylonImageLibrary
Main library interface:
get_image(floor, room, cabinet, shelf, book, page)- Get image by coordinatesget_abstract_image(floor, room, cabinet, shelf, book, page)- Get abstract imagesave_image(floor, room, cabinet, shelf, book, page, filename)- Save image to filesave_abstract_image(floor, room, cabinet, shelf, book, page, filename)- Save abstract imagegenerate_random_image()- Generate and save random imageget_library_info()- Get library information
ImageLibraryConfig
Configuration class:
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
Coordinate class:
floor, room, cabinet, shelf, book, page- Coordinate componentsseed- Combined seed string for generationto_dict()- Convert to dictionaryto_json()- Convert to JSON string
Examples
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")
Storage Location
Images are automatically stored in:
- Linux/Mac:
~/babylonian_image_library/{universe}/ - Windows:
C:\Users\{username}\babylonian_image_library\{universe}\
Deterministic Behavior
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.
License
BSD 3-Clause License Copyright (©) 2026, Alexander Suvorov
Metadata
Release files for babylonian-image-library 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| babylonian_image_library-1.0.1.tar.gz | 12.3 kB | Without provenance | Details for babylonian_image_library-1.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| babylonian_image_library-1.0.1-py3-none-any.whl | Python 3 | none | any | Details for babylonian_image_library-1.0.1-py3-none-any.whl |
Total release size: 23.0 kB
Release files / babylonian_image_library-1.0.1.tar.gz
| Download URL | babylonian_image_library-1.0.1.tar.gz |
|---|---|
| Size | 12.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a7f77b9489d712045d66060153794ead7762d7381dcbb376dff37fd9fa54ce39
|
|
BLAKE2b-256 checksum How to use checksums |
4fd43dcc2b4674039898784585404c62f8fd16c190eed07f59a15b4225945ce9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Release files / babylonian_image_library-1.0.1-py3-none-any.whl
| Download URL | babylonian_image_library-1.0.1-py3-none-any.whl |
|---|---|
| Size | 10.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ab5840a211977309e58dca7f4845410284225f0bf304886726f9d223062c14a6
|
|
BLAKE2b-256 checksum How to use checksums |
1cf9e3bfe2781dbd364c3e89776a02d09185494825e1d3bc0b4c08776f6cb5c6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Security for babylonian-image-library 1.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.