neuronum 5.3.0__tar.gz → 5.4.1__tar.gz

{neuronum-5.3.0/neuronum.egg-info → neuronum-5.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: neuronum
-Version: 5.3.0
+Version: 5.4.1
 Summary: Official client library to interact with the Neuronum Network
 Home-page: https://neuronum.net
 Author: Neuronum Cybernetics
@@ -18,6 +18,7 @@ Requires-Dist: click
 Requires-Dist: questionary
 Requires-Dist: python-dotenv
 Requires-Dist: requests
+Requires-Dist: rapidfuzz
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -30,10 +31,23 @@ Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
-![Neuronum Logo](https://neuronum.net/static/logo_pip.png "Neuronum")
+<h1 align="center">
+  <img src="https://neuronum.net/static/neuronum.svg" alt="Neuronum" width="100">
+</h1>
+<h4 align="center">Build, connect, and automate serverless data infrastructures with Neuronum</h4>
 
-[![Website](https://img.shields.io/badge/Website-Neuronum-blue)](https://neuronum.net) [![Documentation](https://img.shields.io/badge/Docs-Read%20now-green)](https://github.com/neuronumcybernetics/neuronum)
+<p align="center">
+  <a href="https://neuronum.net">
+    <img src="https://img.shields.io/badge/Website-Neuronum-blue" alt="Website">
+  </a>
+  <a href="https://github.com/neuronumcybernetics/neuronum">
+    <img src="https://img.shields.io/badge/Docs-Read%20now-green" alt="Documentation">
+  </a>
+  <img src="https://img.shields.io/badge/Version-5.4.0-blueviolet" alt="Lib Version">
+  <img src="https://img.shields.io/badge/Python-3.9%2B-yellow" alt="Python Version">
+</p>
 
+---
 
 ## **Getting Started Goals**
 - Learn about Neuronum
@@ -56,10 +70,13 @@ Neuronum is a framework to build serverless connected app & data gateways automa
 - Circuits (CTX): Store data in cloud-based key-value-label databases
 - Streams (STX): Stream, synchronize, and control data in real time
 
+**Cellai**
+- Cellai is a CLI-based assistant that helps you interact with Neuronum
+
 
 #### Requirements
-- Python >= 3.8 -> https://www.python.org/downloads/
-- neuronum >= 5.3.0 -> https://pypi.org/project/neuronum/
+- Python >= 3.9 -> https://www.python.org/downloads/
+- neuronum >= 5.4.0 -> https://pypi.org/project/neuronum/
 
 
 ------------------
@@ -76,6 +93,12 @@ Create Cell:
 neuronum create-cell                    # create Cell / Cell type / Cell network 
 ```
 
+or
+
+Connect Cell:
+```sh
+neuronum connect-cell                   # connect Cell
+```
 
 ------------------
 
@@ -104,7 +127,18 @@ Visit: https://github.com/neuronumcybernetics/neuronum/tree/main/how_tos/nodes
 
 
 ### **Interact with Neuronum**
+Web-based:
 1. Visit: https://neuronum.net
 2. Connect your Cell
 3. Explore Transmitters
 4. Activate Transmitters
+
+Code-based:
+```python
+TX = txID                                          # select the Transmitter TX
+data = {
+    "say": "hello",
+}
+tx_response = await cell.activate_tx(TX, data)     # activate TX - > get response back
+print(tx_response)
+```

{neuronum-5.3.0 → neuronum-5.4.1}/README.md

@@ -1,7 +1,20 @@
-![Neuronum Logo](https://neuronum.net/static/logo_pip.png "Neuronum")
-
-[![Website](https://img.shields.io/badge/Website-Neuronum-blue)](https://neuronum.net) [![Documentation](https://img.shields.io/badge/Docs-Read%20now-green)](https://github.com/neuronumcybernetics/neuronum)
-
+<h1 align="center">
+  <img src="https://neuronum.net/static/neuronum.svg" alt="Neuronum" width="100">
+</h1>
+<h4 align="center">Build, connect, and automate serverless data infrastructures with Neuronum</h4>
+
+<p align="center">
+  <a href="https://neuronum.net">
+    <img src="https://img.shields.io/badge/Website-Neuronum-blue" alt="Website">
+  </a>
+  <a href="https://github.com/neuronumcybernetics/neuronum">
+    <img src="https://img.shields.io/badge/Docs-Read%20now-green" alt="Documentation">
+  </a>
+  <img src="https://img.shields.io/badge/Version-5.4.0-blueviolet" alt="Lib Version">
+  <img src="https://img.shields.io/badge/Python-3.9%2B-yellow" alt="Python Version">
+</p>
+
+---
 
 ## **Getting Started Goals**
 - Learn about Neuronum
@@ -24,10 +37,13 @@ Neuronum is a framework to build serverless connected app & data gateways automa
 - Circuits (CTX): Store data in cloud-based key-value-label databases
 - Streams (STX): Stream, synchronize, and control data in real time
 
+**Cellai**
+- Cellai is a CLI-based assistant that helps you interact with Neuronum
+
 
 #### Requirements
-- Python >= 3.8 -> https://www.python.org/downloads/
-- neuronum >= 5.3.0 -> https://pypi.org/project/neuronum/
+- Python >= 3.9 -> https://www.python.org/downloads/
+- neuronum >= 5.4.0 -> https://pypi.org/project/neuronum/
 
 
 ------------------
@@ -44,6 +60,12 @@ Create Cell:
 neuronum create-cell                    # create Cell / Cell type / Cell network 
 ```
 
+or
+
+Connect Cell:
+```sh
+neuronum connect-cell                   # connect Cell
+```
 
 ------------------
 
@@ -72,7 +94,18 @@ Visit: https://github.com/neuronumcybernetics/neuronum/tree/main/how_tos/nodes
 
 
 ### **Interact with Neuronum**
+Web-based:
 1. Visit: https://neuronum.net
 2. Connect your Cell
 3. Explore Transmitters
-4. Activate Transmitters
+4. Activate Transmitters
+
+Code-based:
+```python
+TX = txID                                          # select the Transmitter TX
+data = {
+    "say": "hello",
+}
+tx_response = await cell.activate_tx(TX, data)     # activate TX - > get response back
+print(tx_response)
+```

neuronum-5.4.1/cellai/cellai.py

@@ -0,0 +1,118 @@
+import asyncio
+from rapidfuzz import process
+import neuronum
+import datetime
+from pathlib import Path
+
+
+def log_interaction(user_input, output, log_path=Path("cellai.log")):
+    log_path = Path(log_path)
+
+    timestamp = datetime.datetime.now().isoformat()
+    with open(log_path, "a", encoding="utf-8") as log_file:
+        log_file.write(f"[{timestamp}]\n")
+        log_file.write(f"USER: {user_input}")
+        log_file.write(f"{output}\n\n")
+
+
+async def main(host, password, network, synapse):
+    cell = neuronum.Cell(
+        host=host,
+        password=password,
+        network=network,
+        synapse=synapse
+    )
+
+    tx = await cell.list_tx()
+    nodes = await cell.list_nodes()
+
+    transmitters = tx
+    transmitters_by_id = {t["txID"]: t for t in transmitters}
+
+    info_to_gateway = []
+    for node in nodes:
+        for g in node["Node.md"]["gateways"]:
+            info_to_gateway.append({
+                "nodeID": node["nodeID"],
+                "gateway": g,
+                "info": g["info"],
+                "descr": node["descr"]
+            })
+
+    print("Cellai: Ready for your instruction!")
+    loop = asyncio.get_event_loop()
+
+    while True:
+        try:
+            user_input = await loop.run_in_executor(None, input, ">> ")
+            user_input = user_input.strip()
+            if user_input.lower() in {"exit", "quit"}:
+                log_interaction(user_input, "Session ended by user.")
+                break
+
+            match, score, idx = process.extractOne(user_input, [x["info"] for x in info_to_gateway])
+            best = info_to_gateway[idx]
+
+            output_log = (
+                f"\nMatched: {match} ({score:.1f}%)\n"
+                f"Node: {best['descr']} [{best['nodeID']}]\n"
+                f"Gateway: {best['gateway']['id']} ({best['gateway']['type']})"
+            )
+            print(output_log)
+
+            if best['gateway']['type'] == "transmitter":
+                tx_id = best['gateway']['id']
+                tx_data = transmitters_by_id.get(tx_id)
+                if tx_data:
+                    print(f"Executing transmitter: {tx_data['descr']}")
+                    
+                    dynamic_payload = {}
+                    for key in tx_data["data"].keys():
+                        prompt = f"Enter value for '{key}': "
+                        value = await loop.run_in_executor(None, input, prompt)
+                        dynamic_payload[key] = value
+
+                    print(f"Payload: {dynamic_payload}")
+                    TX = tx_id
+                    tx_response = await cell.activate_tx(TX, dynamic_payload)
+                    print(tx_response["json"])
+                    output_log += f"\nTransmitter executed: {tx_data['descr']}\nPayload: {dynamic_payload}\nResponse: {tx_response['json']}"
+                else:
+                    warning = "Transmitter not found."
+                    print(warning)
+                    output_log += f"{warning}"
+
+            elif best['gateway']['type'] == "stream":
+                STX = best['gateway']['id']
+                print(f"Starting stream sync for STX: {STX}")
+                async for operation in cell.sync(STX):
+                    label = operation.get("label")
+                    data = operation.get("data")
+                    ts = operation.get("time")
+                    stxID = operation.get("stxID")
+                    operator = operation.get("operator")
+                    line = f"[{ts}] {label} | Operator: {operator} | STX: {stxID}\nData: {data}"
+                    print(line)
+                    output_log += f"\n{line}"
+            elif best['gateway']['type'] == "circuit":
+                CTX = best['gateway']['id']
+                label = await loop.run_in_executor(None, input, "Enter label to load from circuit: ")
+                label = label.strip()
+                data = await cell.load(label, CTX)
+                print(data)
+                output_log += f"\nCircuit loaded from CTX: {CTX} with label '{label}'\nData: {data}"
+            else:
+                msg = "Unknown gateway type."
+                print(msg)
+                output_log += f"{msg}"
+
+            log_interaction(user_input, output_log)
+
+        except KeyboardInterrupt:
+            print("\nExiting.")
+            log_interaction("KeyboardInterrupt", "Session exited with Ctrl+C")
+            break
+
+
+if __name__ == "__main__":
+    asyncio.run(main(host, password, network, synapse))

{neuronum-5.3.0 → neuronum-5.4.1}/cli/main.py

@@ -324,40 +324,24 @@ async def async_init_node(sync, stream, app):
 
 ```json
 {
-    "info": {
-        "use_case": "This Node...",
-        "github": "https://github.com/user"
-    },
     "gateways": [
         {
             "type": "stream",
             "id": "id::stx",
-            "link": "https://neuronum.net/stream/id::stx"
+            "link": "https://neuronum.net/stream/id::stx",
+            "info": "stream info"
         },
         {
             "type": "transmitter",
             "id": "id::tx",
-            "link": "https://neuronum.net/tx/id::tx", 
-        }
+            "link": "https://neuronum.net/tx/id::tx",
+            "info": "transmitter info"
+        },
         {
             "type": "circuit",
             "id": "id::ctx",
-            "link": "https://neuronum.net/circuit/id::ctx", 
-        }
-    ],
-    "initialization": {
-        "command": "neuronum init-node --sync id::stx"
-    },
-    "requirements": [
-        {
-            "name": "Python",
-            "version": ">= 3.8",
-            "link": "https://www.python.org/downloads/"
-        },
-        {
-            "name": "neuronum",
-            "version": ">= 5.1.0",
-            "link": "https://pypi.org/project/neuronum/"
+            "link": "https://neuronum.net/circuit/id::ctx",
+            "info": "circuit info"
         }
     ]
 }
@@ -888,6 +872,42 @@ async def async_delete_node():
     click.echo(f"Neuronum Node '{nodeID}' deleted!")
 
 
+@click.command()
+def call_cellai():
+    try:
+        credentials_folder_path = Path.home() / ".neuronum"
+        env_path = credentials_folder_path / ".env"
+
+        env_data = {}  
+
+        try:
+            with open(env_path, "r") as f:
+                for line in f:
+                    key, value = line.strip().split("=")
+                    env_data[key] = value
+
+            host = env_data.get("HOST", "")
+            password = env_data.get("PASSWORD", "")
+            network = env_data.get("NETWORK", "")
+            synapse = env_data.get("SYNAPSE", "")
+        except FileNotFoundError:
+            click.echo("No cell connected. Connect your cell with command neuronum connect-cell")
+            return
+        except Exception as e:
+            click.echo(f"Error reading .env file: {e}")
+            return
+
+        from cellai import cellai
+        asyncio.run(cellai.main(host, password, network, synapse))
+
+    except FileNotFoundError:
+        click.echo("Error: .env with credentials not found")
+    except ImportError:
+        click.echo("Cellai not found. Please check the necessary dependencies.")
+    except Exception as e:
+        click.echo(f"Unexpected error: {e}")
+
+
 cli.add_command(create_cell)
 cli.add_command(connect_cell)
 cli.add_command(view_cell)
@@ -900,6 +920,7 @@ cli.add_command(connect_node)
 cli.add_command(update_node)
 cli.add_command(disconnect_node)
 cli.add_command(delete_node)
+cli.add_command(call_cellai)
 
 
 if __name__ == "__main__":

{neuronum-5.3.0 → neuronum-5.4.1}/neuronum/neuronum.py

@@ -92,8 +92,6 @@ class Cell:
         try:
             async with websockets.connect(full_url) as ws:
                 await ws.send(json.dumps(auth_payload))
-                print("Listening to Stream...")
-
                 try:
                     while True:
                         try:

{neuronum-5.3.0 → neuronum-5.4.1/neuronum.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: neuronum
-Version: 5.3.0
+Version: 5.4.1
 Summary: Official client library to interact with the Neuronum Network
 Home-page: https://neuronum.net
 Author: Neuronum Cybernetics
@@ -18,6 +18,7 @@ Requires-Dist: click
 Requires-Dist: questionary
 Requires-Dist: python-dotenv
 Requires-Dist: requests
+Requires-Dist: rapidfuzz
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -30,10 +31,23 @@ Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
-![Neuronum Logo](https://neuronum.net/static/logo_pip.png "Neuronum")
+<h1 align="center">
+  <img src="https://neuronum.net/static/neuronum.svg" alt="Neuronum" width="100">
+</h1>
+<h4 align="center">Build, connect, and automate serverless data infrastructures with Neuronum</h4>
 
-[![Website](https://img.shields.io/badge/Website-Neuronum-blue)](https://neuronum.net) [![Documentation](https://img.shields.io/badge/Docs-Read%20now-green)](https://github.com/neuronumcybernetics/neuronum)
+<p align="center">
+  <a href="https://neuronum.net">
+    <img src="https://img.shields.io/badge/Website-Neuronum-blue" alt="Website">
+  </a>
+  <a href="https://github.com/neuronumcybernetics/neuronum">
+    <img src="https://img.shields.io/badge/Docs-Read%20now-green" alt="Documentation">
+  </a>
+  <img src="https://img.shields.io/badge/Version-5.4.0-blueviolet" alt="Lib Version">
+  <img src="https://img.shields.io/badge/Python-3.9%2B-yellow" alt="Python Version">
+</p>
 
+---
 
 ## **Getting Started Goals**
 - Learn about Neuronum
@@ -56,10 +70,13 @@ Neuronum is a framework to build serverless connected app & data gateways automa
 - Circuits (CTX): Store data in cloud-based key-value-label databases
 - Streams (STX): Stream, synchronize, and control data in real time
 
+**Cellai**
+- Cellai is a CLI-based assistant that helps you interact with Neuronum
+
 
 #### Requirements
-- Python >= 3.8 -> https://www.python.org/downloads/
-- neuronum >= 5.3.0 -> https://pypi.org/project/neuronum/
+- Python >= 3.9 -> https://www.python.org/downloads/
+- neuronum >= 5.4.0 -> https://pypi.org/project/neuronum/
 
 
 ------------------
@@ -76,6 +93,12 @@ Create Cell:
 neuronum create-cell                    # create Cell / Cell type / Cell network 
 ```
 
+or
+
+Connect Cell:
+```sh
+neuronum connect-cell                   # connect Cell
+```
 
 ------------------
 
@@ -104,7 +127,18 @@ Visit: https://github.com/neuronumcybernetics/neuronum/tree/main/how_tos/nodes
 
 
 ### **Interact with Neuronum**
+Web-based:
 1. Visit: https://neuronum.net
 2. Connect your Cell
 3. Explore Transmitters
 4. Activate Transmitters
+
+Code-based:
+```python
+TX = txID                                          # select the Transmitter TX
+data = {
+    "say": "hello",
+}
+tx_response = await cell.activate_tx(TX, data)     # activate TX - > get response back
+print(tx_response)
+```

{neuronum-5.3.0 → neuronum-5.4.1}/neuronum.egg-info/SOURCES.txt

@@ -1,6 +1,8 @@
 LICENSE
 README.md
 setup.py
+cellai/__init__.py
+cellai/cellai.py
 cli/__init__.py
 cli/main.py
 neuronum/__init__.py

{neuronum-5.3.0 → neuronum-5.4.1}/neuronum.egg-info/requires.txt

@@ -4,3 +4,4 @@ click
 questionary
 python-dotenv
 requests
+rapidfuzz

{neuronum-5.3.0 → neuronum-5.4.1}/neuronum.egg-info/top_level.txt

@@ -1,2 +1,3 @@
+cellai
 cli
 neuronum

{neuronum-5.3.0 → neuronum-5.4.1}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name='neuronum',
-    version='5.3.0',
+    version='5.4.1',
     author='Neuronum Cybernetics',
     author_email='welcome@neuronum.net',
     description='Official client library to interact with the Neuronum Network',
@@ -12,7 +12,7 @@ setup(
     project_urls={
         "GitHub": "https://github.com/neuronumcybernetics/neuronum",
     },
-    packages=find_packages(include=["neuronum", "cli"]),
+    packages=find_packages(include=["neuronum", "cellai", "cli"]),
     classifiers=[
         "Programming Language :: Python :: 3",
         "License :: OSI Approved :: MIT License",
@@ -26,6 +26,7 @@ setup(
         'questionary',
         'python-dotenv',
         'requests',
+        'rapidfuzz',
     ],
     entry_points={
         "console_scripts": [