Skip to main content

Conscious Bridge Law Logo

🌉 Conscious Bridge Law

Transitional Geometry between Aristotelian and Platonic Logic in AI

Transitional Geometry between Aristotelian and Platonic Logic in AI

Python 3.8+ License: MIT License: CC BY 4.0 DOI GitHub Stars GitLab Last Commit

By Samir Baladi | December 3, 2025


📖 Table of Contents

  • Overview
  • Quick Start
  • Installation
  • φ Components
  • Usage
  • Repository Structure
  • Citation
  • License
  • Contributing
  • Contact
  • Links
  • Release History

--

🎯 Overview

Instead of forcing AI to choose between:

  • Deterministic (Aristotelian: T=0)
  • Probabilistic (Platonic: T=1.5)

We introduce a third space: The Conscious Bridge (T ∈ [0.4, 0.8])

Aristotle ←─── Conscious Bridge (φ) ───→ Plato
T = 0.0          T = 0.6                T = 1.5
Certain          Aware                  Creative

Key Innovation: φ (Phi)

φ measures the model's awareness of its position on the bridge:

  • φ = 0: Unconscious transition (random drift)
  • φ = 1: Fully conscious (controlled navigation)

🚀 Quick Start

from engine.conscious_law import ConsciousBridgeLaw

# Initialize
model = ConsciousBridgeLaw()

# Generate with awareness
output, phi, components = model.generate_with_awareness(
    input_text="Artificial intelligence is evolving",
    base_temperature=0.7,
    adaptive_temp=True
)

print(f"Bridge Awareness (φ): {phi:.3f}")
print(f"Generated: {output}")

📦 Installation

# Clone repository
git clone https://github.com/riteofrenaissance/Conscious-Bridge-Law.git
cd Conscious-Bridge-Law

# Install dependencies
pip install -r requirements.txt

# Optional: Install in development mode
pip install -e .

Requirements: Python 3.8+, PyTorch 1.9+ or TensorFlow 2.5+


📊 φ Components

Component Weight Description
Strength 35% Context representation power (‖hₜ‖)
Attention 30% Attention mechanism clarity
Stability 25% Language stability (distance from centers)
Context 10% Input context quality

💻 Usage Examples

Basic Usage

from engine.conscious_law import ConsciousBridgeLaw

model = ConsciousBridgeLaw()
output, phi, _ = model.generate_with_awareness(
    input_text="The nature of consciousness",
    base_temperature=0.6
)

Advanced: Monitoring φ

import matplotlib.pyplot as plt

phi_history = []
for i in range(10):
    _, phi, _ = model.generate_with_awareness(
        input_text=f"Step {i}: AI evolution",
        base_temperature=0.5 + (i * 0.05)
    )
    phi_history.append(phi)

# Visualize φ evolution
plt.plot(phi_history, marker='o')
plt.xlabel('Iteration')
plt.ylabel('φ Value')
plt.title('Conscious Bridge Awareness Evolution')
plt.grid(True)
plt.show()

📂 Repository Structure



Conscious-Bridge-Law/
├── core/                    # Core algorithms
│   ├── bridge_map.py
│   ├── bridge_dynamics.py
│   ├── phi_calculator.py
│   ├── language_centers.py
│   └── attention_metrics.py
├── engine/                  # Main engine
│   ├── conscious_law.py
│   ├── temperature_adapter.py
│   └── stability_monitor.py
├── bos/                     # State management
│   ├── identity_layer.py
│   ├── role_manager.py
│   └── state_manager.py
├── demos/                   # Example scripts
│   ├── arabic_context.py
│   ├── mixed_language.py
│   ├── philosophical_queries.py
│   ├── web_demo.py                 # DeepSeek addition
│   ├── advanced_simulation.py      # DeepSeek addition
│   ├── multi_language_demo.py      # DeepSeek addition
│   └── data_analysis_demo.py       # DeepSeek addition
├── utils/                   # Utilities
│   ├── token_analysis.py
│   ├── metrics.py
│   ├── phi_logger.py               # DeepSeek addition
│   └── visualizer.py               # DeepSeek addition
├── tests/                   # Test suite
│   ├── test_phi.py
│   ├── test_bridge_map.py          # DeepSeek addition
│   ├── test_bridge_dynamics.py    # DeepSeek addition
│   ├── test_phi_calculator.py     # DeepSeek addition
│   └── test_conscious_law.py      # DeepSeek addition
├── docs/                    # Documentation and images
│   ├── bridge.png                  # Logo
│   ├── example_output.png
│   ├── architecture_diagram.png
│   ├── research_paper.md          # DeepSeek addition
│   └── tutorial.md                # DeepSeek addition
├── requirements.txt         # Dependencies
├── setup.py                  # Optional: Package installer
├── pyproject.toml           # Optional: Package configuration
├── LICENSE-MIT.txt          # MIT License
├── LICENSE-CC-BY.txt        # CC-BY License
├── CONTRIBUTING.md          # Contribution guidelines
├── .gitignore               # Ignore patterns for Git
└── README.md                # Main README


🎓 Citation

@software{baladi_2025_conscious_bridge,
  author       = {Baladi, Samir},
  title        = {{Conscious Bridge Law: Implementation}},
  year         = 2025,
  publisher    = {Zenodo},
  doi          = {10.5281/zenodo.17814683},
  url          = {https://doi.org/10.5281/zenodo.17814683}
}

⚖️ License

  • Code: MIT License
  • Documentation & Papers: CC-BY 4.0

See LICENSE-MIT.txt and LICENSE-CC-BY.txt


🤝 Contributing

We welcome contributions! Please:

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a Pull Request

See CONTRIBUTING.md for detailed guidelines.


📬 Contact

Maintainer: Samir Baladi
Email: riteofrenaissance@proton.me
Issues: GitHub Issues



📈 Release History

v1.0.0 (December 2025)

  • Initial release of Conscious Bridge Law
  • Core φ calculation algorithms
  • Demo scripts and examples
  • Complete documentation

"Bridging the gap between certainty and creativity in AI"

Metadata

Release files for conscious-bridge 1.0.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for conscious-bridge 1.0.4
File Size Uploaded Provenance
conscious_bridge-1.0.4.tar.gz 12.2 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for conscious-bridge 1.0.4
File Interpreter ABI Platform
conscious_bridge-1.0.4-py3-none-any.whl Python 3 none any Details

Total release size: 25.3 kB

Release files / conscious_bridge-1.0.4.tar.gz

Download URL conscious_bridge-1.0.4.tar.gz
Size 12.2 kB
Tags Source
SHA-256 checksum
How to use checksums
d5fb2479c1b1dd52d69b59a48d0bf175678aa06b67e062dd405522030ef75bb4
BLAKE2b-256 checksum
How to use checksums
9c7c7080c965261c6c33cc049c75fab0c2525312bd431e7b664cdc00b623bfae
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/2.0.0 pkginfo/1.12.1.2 requests/2.32.5 setuptools/80.9.0 requests-toolbelt/1.0.0 tqdm/4.67.1 CPython/3.12.12

Release files / conscious_bridge-1.0.4-py3-none-any.whl

Download URL conscious_bridge-1.0.4-py3-none-any.whl
Size 13.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f41b3ba0c202d68697c27615e0fd0fb970e44805be17d1df390ab81174e386c3
BLAKE2b-256 checksum
How to use checksums
cc21ed1f10fbc437256d446ee9fadff8ffb84f8d626c1ac04190eb3ab6fd75a2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/2.0.0 pkginfo/1.12.1.2 requests/2.32.5 setuptools/80.9.0 requests-toolbelt/1.0.0 tqdm/4.67.1 CPython/3.12.12

Security for conscious-bridge 1.0.4

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page