neuronum 5.3.0__py3-none-any.whl → 5.4.1__py3-none-any.whl

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))

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/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.dist-info → neuronum-5.4.1.dist-info}/METADATA

@@ -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.4.1.dist-info/RECORD

@@ -0,0 +1,12 @@
+cellai/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cellai/cellai.py,sha256=LjJqF0dpk1Vjq-QLiGdzUi6IIDZwPcgvsn4Cjjp4JJ8,4559
+cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cli/main.py,sha256=wu0oggPk-VzONIzcyPKibyWhiT4kbI_6SZUsSrOkVYo,28479
+neuronum/__init__.py,sha256=Drsm263_w3_VWgl1YsKLUr8WwVodqV3TSjqpxLjyq_M,46
+neuronum/neuronum.py,sha256=gaQTvv8llmc36yBG8UwijCOoi6_uvifJyJ4z3KuiQqQ,17382
+neuronum-5.4.1.dist-info/licenses/LICENSE,sha256=UiZjNHiCyRP6WoZfbYQh9cv4JW96wIofKXmzBJrYSUk,1125
+neuronum-5.4.1.dist-info/METADATA,sha256=vidSOj_xGdoGX6SkrujUDMePL5YvX7w7ZK-tlDbmR54,3831
+neuronum-5.4.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+neuronum-5.4.1.dist-info/entry_points.txt,sha256=XKYBcRNxGeJpZZkDPsa8HA_RaJ7Km_R_JaUq5T9Nk2U,42
+neuronum-5.4.1.dist-info/top_level.txt,sha256=gqN5tyGnBKMPSzvWQONO4rpTf4gQPMi77O3KAKx88LQ,20
+neuronum-5.4.1.dist-info/RECORD,,

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

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

neuronum-5.3.0.dist-info/RECORD

@@ -1,10 +0,0 @@
-cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-cli/main.py,sha256=b9RRqNCyd05eit9zH8pl9hndMc9zjJ-S-3jKSE3dqNw,27625
-neuronum/__init__.py,sha256=Drsm263_w3_VWgl1YsKLUr8WwVodqV3TSjqpxLjyq_M,46
-neuronum/neuronum.py,sha256=9oNS8e1d95XfnKieycpQTK8huZY3rwGdNGBy9O0eVEQ,17433
-neuronum-5.3.0.dist-info/licenses/LICENSE,sha256=UiZjNHiCyRP6WoZfbYQh9cv4JW96wIofKXmzBJrYSUk,1125
-neuronum-5.3.0.dist-info/METADATA,sha256=gxacp8b2Bl7fczHdi3cW_G9T0iAB60In-3pVzJy8kyI,2945
-neuronum-5.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-neuronum-5.3.0.dist-info/entry_points.txt,sha256=XKYBcRNxGeJpZZkDPsa8HA_RaJ7Km_R_JaUq5T9Nk2U,42
-neuronum-5.3.0.dist-info/top_level.txt,sha256=ru8Fr84cHm6oHr_DcJ8-uaq3RTiuCRFIr6AC8V0zPu4,13
-neuronum-5.3.0.dist-info/RECORD,,