Welcome to CLE-Net's documentation!
=====================================

.. image:: https://img.shields.io/badge/Phase-5%20Cosmos%20SDK-orange
   :target: ROADMAP.md
   :alt: Project Phase

.. image:: https://img.shields.io/badge/Status-Production--ready-brightgreen
   :target: ROADMAP.md
   :alt: Project Status

CLE-Net is an experimental decentralized architecture for autonomous cognitive agents that extract, preserve, and evolve symbolic laws from human interaction — independent of any single machine, model, or operator.

*Intelligence is not an answer. Intelligence is continuity of understanding over time.*

.. toctree::
   :maxdepth: 2
   :caption: Contents:

   Getting Started <self>
   glossary.md
   architecture/index.rst
   cosmos/index.rst
   protocols/index.rst
   whitepaper/index.rst

Quick Start
-----------

Installation:

.. code-block:: bash

   pip install cle-net

Or from source:

.. code-block:: bash

   git clone https://github.com/Abdelrahman-sadek/CLE-Net.git
   cd CLE-Net
   pip install -r requirements.txt
   pip install -e .

Features
--------

- **Cognitive Discovery**: Discovers implicit rules from human interaction
- **Decentralized**: No single point of control or failure
- **Proof of Cognition**: Novel consensus through independent discovery
- **Cosmos SDK**: Production-ready blockchain integration

Indices and tables
------------------

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

API Reference
-------------

For detailed API documentation, see the :doc:`architecture/index`.

Contributing
------------

Please read our :doc:`../CONTRIBUTING` for details on our code of conduct and the process for submitting pull requests.

License
-------

This project is licensed under the MIT License - see the :doc:`../LICENSE` file for details.

Acknowledgments
---------------

- Thanks to all contributors who have helped shape CLE-Net
- Built with ❤️ for the future of decentralized AI