neuronum 5.2.0__tar.gz → 5.4.0__tar.gz

{neuronum-5.2.0/neuronum.egg-info → neuronum-5.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: neuronum
-Version: 5.2.0
+Version: 5.4.0
 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
@@ -39,6 +40,7 @@ Dynamic: summary
 - Learn about Neuronum
 - Connect to Neuronum
 - Build on Neuronum
+- Interact with Neuronum
 
 
 ### **About Neuronum**
@@ -55,10 +57,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 >= 4.0.0 -> https://pypi.org/project/neuronum/
+- neuronum >= 5.4.0 -> https://pypi.org/project/neuronum/
 
 
 ------------------
@@ -82,22 +87,18 @@ Connect Cell:
 neuronum connect-cell                   # connect Cell
 ```
 
-View connected Cell:
-```sh
-neuronum view-cell                      # view Cell / output = Connected Cell: 'cell_id'"
-```
-
-
 ------------------
 
 
 ### **Build on Neuronum**
-**Node Examples:**  
-Visit: https://github.com/neuronumcybernetics/neuronum/tree/main/how_tos/nodes
+Initialize Node (app template):
+```sh
+neuronum init-node --app                # initialize a Node with app template
+```
 
-Initialize Node (default template):
+Change into Node folder
 ```sh
-neuronum init-node                      # initialize a Node with default template
+cd node_node_id                         # change directory
 ```
 
 Start Node:
@@ -105,12 +106,15 @@ Start Node:
 neuronum start-node                     # start Node
 ```
 
-Stop Node:
-```sh
-neuronum stop-node                      # stop Node
-```
+**Node Examples**
+Visit: https://github.com/neuronumcybernetics/neuronum/tree/main/how_tos/nodes
 
-Connect Node to Neuronum:
-```sh
-neuronum connect-node                   # connect Node
-```
+
+------------------
+
+
+### **Interact with Neuronum**
+1. Visit: https://neuronum.net
+2. Connect your Cell
+3. Explore Transmitters
+4. Activate Transmitters

{neuronum-5.2.0 → neuronum-5.4.0}/README.md

@@ -7,6 +7,7 @@
 - Learn about Neuronum
 - Connect to Neuronum
 - Build on Neuronum
+- Interact with Neuronum
 
 
 ### **About Neuronum**
@@ -23,10 +24,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 >= 4.0.0 -> https://pypi.org/project/neuronum/
+- neuronum >= 5.4.0 -> https://pypi.org/project/neuronum/
 
 
 ------------------
@@ -50,22 +54,18 @@ Connect Cell:
 neuronum connect-cell                   # connect Cell
 ```
 
-View connected Cell:
-```sh
-neuronum view-cell                      # view Cell / output = Connected Cell: 'cell_id'"
-```
-
-
 ------------------
 
 
 ### **Build on Neuronum**
-**Node Examples:**  
-Visit: https://github.com/neuronumcybernetics/neuronum/tree/main/how_tos/nodes
+Initialize Node (app template):
+```sh
+neuronum init-node --app                # initialize a Node with app template
+```
 
-Initialize Node (default template):
+Change into Node folder
 ```sh
-neuronum init-node                      # initialize a Node with default template
+cd node_node_id                         # change directory
 ```
 
 Start Node:
@@ -73,12 +73,15 @@ Start Node:
 neuronum start-node                     # start Node
 ```
 
-Stop Node:
-```sh
-neuronum stop-node                      # stop Node
-```
+**Node Examples**
+Visit: https://github.com/neuronumcybernetics/neuronum/tree/main/how_tos/nodes
 
-Connect Node to Neuronum:
-```sh
-neuronum connect-node                   # connect Node
-```
+
+------------------
+
+
+### **Interact with Neuronum**
+1. Visit: https://neuronum.net
+2. Connect your Cell
+3. Explore Transmitters
+4. Activate Transmitters

neuronum-5.4.0/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.2.0 → neuronum-5.4.0}/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"
         }
     ]
 }
@@ -500,7 +484,23 @@ async def main():
 asyncio.run(main())
 """)
         
-    if app:
+    if app and nodeID:
+
+        descr = f"{nodeID} App"                                                  
+        partners = ["public"]                                      
+        stxID = await cell.create_stx(descr, partners)  
+
+
+        descr = f"Greet {nodeID}"                                           
+        key_values = {                                                          
+            "say": "hello",
+        }
+        STX = stxID                                                     
+        label = "say:hello"                                                                                                                                                         
+        partners = ["public"]                                                   
+        txID = await cell.create_tx(descr, key_values, STX, label, partners)
+
+
         app_path = project_path / "app.py"
         app_path.write_text(f"""\
 import asyncio
@@ -521,27 +521,31 @@ cell = neuronum.Cell(
     synapse=synapse
 )
 
-async def main():
-    STX = "id::stx"                        
+async def main():      
+    STX = "{stxID}"                                          
     async for operation in cell.sync(STX):       
         txID = operation.get("txID")
         client = operation.get("operator")                    
                             
-        if txID == "id::tx":             
-            data = {{
-                "response": "TX activated!"
-            }}
-            await cell.tx_response(txID, client, data)
-
-        if txID == "id::tx":
+        if txID == "{txID}":             
             data = {{
-                "response": "TX activated!"
-            }}
-            await cell.tx_response(txID, client, data)
+                "json": f"Hello {{client}} from {nodeID}",
+                "html": f\"\"\"
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="UTF-8">
+    <title>Greeting Node</title>
+  </head>
+  <body>
+    <div class="card">
+      <h1>Hello, {{client}}</h1>
+      <p>Greetings from <span class="node">{nodeID}</span></p>
+    </div>
+  </body>
+</html>
+\"\"\"
 
-        if txID == "id::tx":
-            data = {{
-                "response": "TX activated!"
             }}
             await cell.tx_response(txID, client, data)
 
@@ -868,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)
@@ -880,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.2.0 → neuronum-5.4.0}/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.2.0 → neuronum-5.4.0/neuronum.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: neuronum
-Version: 5.2.0
+Version: 5.4.0
 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
@@ -39,6 +40,7 @@ Dynamic: summary
 - Learn about Neuronum
 - Connect to Neuronum
 - Build on Neuronum
+- Interact with Neuronum
 
 
 ### **About Neuronum**
@@ -55,10 +57,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 >= 4.0.0 -> https://pypi.org/project/neuronum/
+- neuronum >= 5.4.0 -> https://pypi.org/project/neuronum/
 
 
 ------------------
@@ -82,22 +87,18 @@ Connect Cell:
 neuronum connect-cell                   # connect Cell
 ```
 
-View connected Cell:
-```sh
-neuronum view-cell                      # view Cell / output = Connected Cell: 'cell_id'"
-```
-
-
 ------------------
 
 
 ### **Build on Neuronum**
-**Node Examples:**  
-Visit: https://github.com/neuronumcybernetics/neuronum/tree/main/how_tos/nodes
+Initialize Node (app template):
+```sh
+neuronum init-node --app                # initialize a Node with app template
+```
 
-Initialize Node (default template):
+Change into Node folder
 ```sh
-neuronum init-node                      # initialize a Node with default template
+cd node_node_id                         # change directory
 ```
 
 Start Node:
@@ -105,12 +106,15 @@ Start Node:
 neuronum start-node                     # start Node
 ```
 
-Stop Node:
-```sh
-neuronum stop-node                      # stop Node
-```
+**Node Examples**
+Visit: https://github.com/neuronumcybernetics/neuronum/tree/main/how_tos/nodes
 
-Connect Node to Neuronum:
-```sh
-neuronum connect-node                   # connect Node
-```
+
+------------------
+
+
+### **Interact with Neuronum**
+1. Visit: https://neuronum.net
+2. Connect your Cell
+3. Explore Transmitters
+4. Activate Transmitters

{neuronum-5.2.0 → neuronum-5.4.0}/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.2.0 → neuronum-5.4.0}/neuronum.egg-info/requires.txt

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

{neuronum-5.2.0 → neuronum-5.4.0}/neuronum.egg-info/top_level.txt

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

{neuronum-5.2.0 → neuronum-5.4.0}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name='neuronum',
-    version='5.2.0',
+    version='5.4.0',
     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": [