trustgraph-flow 0.18.2__tar.gz → 0.18.3__tar.gz

{trustgraph-flow-0.18.2 → trustgraph-flow-0.18.3}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.1
 Name: trustgraph-flow
-Version: 0.18.2
+Version: 0.18.3
 Summary: TrustGraph provides a means to run a pipeline of flexible AI processing components in a flexible means to achieve a processing pipeline.
 Home-page: https://github.com/trustgraph-ai/trustgraph
 Author: trustgraph.ai
 Author-email: security@trustgraph.ai
 License: UNKNOWN
-Download-URL: https://github.com/trustgraph-ai/trustgraph/archive/refs/tags/v0.18.2.tar.gz
+Download-URL: https://github.com/trustgraph-ai/trustgraph/archive/refs/tags/v0.18.3.tar.gz
 Platform: UNKNOWN
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)

trustgraph-flow-0.18.3/scripts/triples-query-falkordb

@@ -0,0 +1,6 @@
+#!/usr/bin/env python3
+
+from trustgraph.query.triples.falkordb import run
+
+run()
+

trustgraph-flow-0.18.3/scripts/triples-write-falkordb

@@ -0,0 +1,6 @@
+#!/usr/bin/env python3
+
+from trustgraph.storage.triples.falkordb import run
+
+run()
+

{trustgraph-flow-0.18.2 → trustgraph-flow-0.18.3}/setup.py

@@ -60,6 +60,7 @@ setuptools.setup(
         "jsonschema",
         "aiohttp",
         "pinecone[grpc]",
+        "falkordb",
     ],
     scripts=[
         "scripts/api-gateway",
@@ -104,9 +105,11 @@ setuptools.setup(
         "scripts/triples-query-cassandra",
         "scripts/triples-query-neo4j",
         "scripts/triples-query-memgraph",
+        "scripts/triples-query-falkordb",
         "scripts/triples-write-cassandra",
         "scripts/triples-write-neo4j",
         "scripts/triples-write-memgraph",
+        "scripts/triples-write-falkordb",
         "scripts/wikipedia-lookup",
     ]
 )

trustgraph-flow-0.18.3/trustgraph/flow_version.py

@@ -0,0 +1 @@
+__version__ = "0.18.3"

trustgraph-flow-0.18.3/trustgraph/query/triples/falkordb/service.py

@@ -0,0 +1,341 @@
+
+"""
+Triples query service for FalkorDB.
+Input is a (s, p, o) triple, some values may be null.  Output is a list of
+triples.
+"""
+
+from falkordb import FalkorDB
+
+from .... schema import TriplesQueryRequest, TriplesQueryResponse, Error
+from .... schema import Value, Triple
+from .... schema import triples_request_queue
+from .... schema import triples_response_queue
+from .... base import ConsumerProducer
+
+module = ".".join(__name__.split(".")[1:-1])
+
+default_input_queue = triples_request_queue
+default_output_queue = triples_response_queue
+default_subscriber = module
+
+default_graph_url = 'falkor://falkordb:6379'
+default_database = 'falkordb'
+
+class Processor(ConsumerProducer):
+
+    def __init__(self, **params):
+
+        input_queue = params.get("input_queue", default_input_queue)
+        output_queue = params.get("output_queue", default_output_queue)
+        subscriber = params.get("subscriber", default_subscriber)
+        graph_url = params.get("graph_host", default_graph_url)
+        database = params.get("database", default_database)
+
+        super(Processor, self).__init__(
+            **params | {
+                "input_queue": input_queue,
+                "output_queue": output_queue,
+                "subscriber": subscriber,
+                "input_schema": TriplesQueryRequest,
+                "output_schema": TriplesQueryResponse,
+                "graph_url": graph_url,
+            }
+        )
+
+        self.db = database
+
+        self.io = FalkorDB.from_url(graph_url).select_graph(database)
+
+    def create_value(self, ent):
+
+        if ent.startswith("http://") or ent.startswith("https://"):
+            return Value(value=ent, is_uri=True)
+        else:
+            return Value(value=ent, is_uri=False)
+
+    def handle(self, msg):
+
+        try:
+
+            v = msg.value()
+
+            # Sender-produced ID
+            id = msg.properties()["id"]
+
+            print(f"Handling input {id}...", flush=True)
+
+            triples = []
+
+            if v.s is not None:
+                if v.p is not None:
+                    if v.o is not None:
+
+                        # SPO
+
+                        records = self.io.query(
+                            "MATCH (src:Node {uri: $src})-[rel:Rel {uri: $rel}]->(dest:Literal {value: $value}) "
+                            "RETURN $src as src",
+                            src=v.s.value, rel=v.p.value, value=v.o.value,
+                            database_=self.db,
+                        ).result_set
+
+                        for rec in records:
+                            triples.append((v.s.value, v.p.value, v.o.value))
+
+                        records = self.io.query(
+                            "MATCH (src:Node {uri: $src})-[rel:Rel {uri: $rel}]->(dest:Node {uri: $uri}) "
+                            "RETURN $src as src",
+                            src=v.s.value, rel=v.p.value, uri=v.o.value,
+                            database_=self.db,
+                        ).result_set
+
+                        for rec in records:
+                            triples.append((v.s.value, v.p.value, v.o.value))
+
+                    else:
+
+                        # SP
+
+                        records = self.io.query(
+                            "MATCH (src:Node {uri: $src})-[rel:Rel {uri: $rel}]->(dest:Literal) "
+                            "RETURN dest.value as dest",
+                            src=v.s.value, rel=v.p.value,
+                            database_=self.db,
+                        ).result_set
+
+                        for rec in records:
+                            data = rec.data()
+                            triples.append((v.s.value, v.p.value, data["dest"]))
+
+                        records = self.io.query(
+                            "MATCH (src:Node {uri: $src})-[rel:Rel {uri: $rel}]->(dest:Node) "
+                            "RETURN dest.uri as dest",
+                            src=v.s.value, rel=v.p.value,
+                            database_=self.db,
+                        ).result_set
+
+                        for rec in records:
+                            data = rec.data()
+                            triples.append((v.s.value, v.p.value, data["dest"]))
+
+                else:
+
+                    if v.o is not None:
+
+                        # SO
+
+                        records = self.io.query(
+                            "MATCH (src:Node {uri: $src})-[rel:Rel]->(dest:Literal {value: $value}) "
+                            "RETURN rel.uri as rel",
+                            src=v.s.value, value=v.o.value,
+                            database_=self.db,
+                        ).result_set
+
+                        for rec in records:
+                            data = rec.data()
+                            triples.append((v.s.value, data["rel"], v.o.value))
+
+                        records = self.io.query(
+                            "MATCH (src:Node {uri: $src})-[rel:Rel]->(dest:Node {uri: $uri}) "
+                            "RETURN rel.uri as rel",
+                            src=v.s.value, uri=v.o.value,
+                            database_=self.db,
+                        ).result_set
+
+                        for rec in records:
+                            data = rec.data()
+                            triples.append((v.s.value, data["rel"], v.o.value))
+
+                    else:
+
+                        # S
+
+                        records = self.io.query(
+                            "MATCH (src:Node {uri: $src})-[rel:Rel]->(dest:Literal) "
+                            "RETURN rel.uri as rel, dest.value as dest",
+                            src=v.s.value,
+                            database_=self.db,
+                        ).result_set
+
+                        for rec in records:
+                            data = rec.data()
+                            triples.append((v.s.value, data["rel"], data["dest"]))
+
+                        records = self.io.query(
+                            "MATCH (src:Node {uri: $src})-[rel:Rel]->(dest:Node) "
+                            "RETURN rel.uri as rel, dest.uri as dest",
+                            src=v.s.value,
+                            database_=self.db,
+                        ).result_set
+
+                        for rec in records:
+                            data = rec.data()
+                            triples.append((v.s.value, data["rel"], data["dest"]))
+
+
+            else:
+
+                if v.p is not None:
+
+                    if v.o is not None:
+
+                        # PO
+
+                        records = self.io.query(
+                            "MATCH (src:Node)-[rel:Rel {uri: $uri}]->(dest:Literal {value: $value}) "
+                            "RETURN src.uri as src",
+                            uri=v.p.value, value=v.o.value,
+                            database_=self.db,
+                        ).result_set
+
+                        for rec in records:
+                            data = rec.data()
+                            triples.append((data["src"], v.p.value, v.o.value))
+
+                        records = self.io.query(
+                            "MATCH (src:Node)-[rel:Rel {uri: $uri}]->(dest:Node {uri: $uri}) "
+                            "RETURN src.uri as src",
+                            uri=v.p.value, dest=v.o.value,
+                            database_=self.db,
+                        ).result_set
+
+                        for rec in records:
+                            data = rec.data()
+                            triples.append((data["src"], v.p.value, v.o.value))
+
+                    else:
+
+                        # P
+
+                        records = self.io.query(
+                            "MATCH (src:Node)-[rel:Rel {uri: $uri}]->(dest:Literal) "
+                            "RETURN src.uri as src, dest.value as dest",
+                            uri=v.p.value,
+                            database_=self.db,
+                        ).result_set
+
+                        for rec in records:
+                            data = rec.data()
+                            triples.append((data["src"], v.p.value, data["dest"]))
+
+                        records = self.io.query(
+                            "MATCH (src:Node)-[rel:Rel {uri: $uri}]->(dest:Node) "
+                            "RETURN src.uri as src, dest.uri as dest",
+                            uri=v.p.value,
+                            database_=self.db,
+                        ).result_set
+
+                        for rec in records:
+                            data = rec.data()
+                            triples.append((data["src"], v.p.value, data["dest"]))
+
+                else:
+
+                    if v.o is not None:
+
+                        # O
+
+                        records = self.io.query(
+                            "MATCH (src:Node)-[rel:Rel]->(dest:Literal {value: $value}) "
+                            "RETURN src.uri as src, rel.uri as rel",
+                            value=v.o.value,
+                            database_=self.db,
+                        ).result_set
+
+                        for rec in records:
+                            data = rec.data()
+                            triples.append((data["src"], data["rel"], v.o.value))
+
+                        records = self.io.query(
+                            "MATCH (src:Node)-[rel:Rel]->(dest:Node {uri: $uri}) "
+                            "RETURN src.uri as src, rel.uri as rel",
+                            uri=v.o.value,
+                            database_=self.db,
+                        ).result_set
+
+                        for rec in records:
+                            data = rec.data()
+                            triples.append((data["src"], data["rel"], v.o.value))
+
+                    else:
+
+                        # *
+
+                        records = self.io.query(
+                            "MATCH (src:Node)-[rel:Rel]->(dest:Literal) "
+                            "RETURN src.uri as src, rel.uri as rel, dest.value as dest",
+                            database_=self.db,
+                        ).result_set
+
+                        for rec in records:
+                            data = rec.data()
+                            triples.append((data["src"], data["rel"], data["dest"]))
+
+                        records = self.io.query(
+                            "MATCH (src:Node)-[rel:Rel]->(dest:Node) "
+                            "RETURN src.uri as src, rel.uri as rel, dest.uri as dest",
+                            database_=self.db,
+                        ).result_set
+
+                        for rec in records:
+                            data = rec.data()
+                            triples.append((data["src"], data["rel"], data["dest"]))
+
+            triples = [
+                Triple(
+                    s=self.create_value(t[0]),
+                    p=self.create_value(t[1]), 
+                    o=self.create_value(t[2])
+                )
+                for t in triples
+            ]
+
+            print("Send response...", flush=True)
+            r = TriplesQueryResponse(triples=triples, error=None)
+            self.producer.send(r, properties={"id": id})
+
+            print("Done.", flush=True)
+
+        except Exception as e:
+
+            print(f"Exception: {e}")
+
+            print("Send error response...", flush=True)
+
+            r = TriplesQueryResponse(
+                error=Error(
+                    type = "llm-error",
+                    message = str(e),
+                ),
+                response=None,
+            )
+
+            self.producer.send(r, properties={"id": id})
+
+            self.consumer.acknowledge(msg)
+            
+    @staticmethod
+    def add_args(parser):
+
+        ConsumerProducer.add_args(
+            parser, default_input_queue, default_subscriber,
+            default_output_queue,
+        )
+
+        parser.add_argument(
+            '-g', '--graph-url',
+            default=default_graph_url,
+            help=f'Graph url (default: {default_graph_url})'
+        )
+
+        parser.add_argument(
+            '--database',
+            default=default_database,
+            help=f'FalkorDB database (default: {default_database})'
+        )
+
+def run():
+
+    Processor.start(module, __doc__)
+

trustgraph-flow-0.18.3/trustgraph/query/triples/neo4j/__init__.py

@@ -0,0 +1,3 @@
+
+from . service import *
+

trustgraph-flow-0.18.3/trustgraph/query/triples/neo4j/__main__.py

@@ -0,0 +1,7 @@
+#!/usr/bin/env python3
+
+from . hf import run
+
+if __name__ == '__main__':
+    run()
+

trustgraph-flow-0.18.3/trustgraph/storage/triples/falkordb/write.py

@@ -0,0 +1,150 @@
+
+"""
+Graph writer.  Input is graph edge.  Writes edges to FalkorDB graph.
+"""
+
+import pulsar
+import base64
+import os
+import argparse
+import time
+
+from falkordb import FalkorDB
+
+from .... schema import Triples
+from .... schema import triples_store_queue
+from .... log_level import LogLevel
+from .... base import Consumer
+
+module = ".".join(__name__.split(".")[1:-1])
+
+default_input_queue = triples_store_queue
+default_subscriber = module
+
+default_graph_url = 'falkor://falkordb:6379'
+default_database = 'falkordb'
+
+class Processor(Consumer):
+
+    def __init__(self, **params):
+        
+        input_queue = params.get("input_queue", default_input_queue)
+        subscriber = params.get("subscriber", default_subscriber)
+        graph_url = params.get("graph_host", default_graph_url)
+        database = params.get("database", default_database)
+
+        super(Processor, self).__init__(
+            **params | {
+                "input_queue": input_queue,
+                "subscriber": subscriber,
+                "input_schema": Triples,
+                "graph_url": graph_url,
+            }
+        )
+
+        self.db = database
+
+        self.io = FalkorDB.from_url(graph_url).select_graph(database)
+
+    def create_node(self, uri):
+
+        print("Create node", uri)
+
+        res = self.io.query(
+            "MERGE (n:Node {uri: $uri})",
+            uri=uri,
+            database_=self.db,
+        )
+
+        print("Created {nodes_created} nodes in {time} ms.".format(
+            nodes_created=res.nodes_created,
+            time=res.run_time_ms
+        ))
+
+    def create_literal(self, value):
+
+        print("Create literal", value)
+
+        res = self.io.query(
+            "MERGE (n:Literal {value: $value})",
+            value=value,
+            database_=self.db,
+        )
+
+        print("Created {nodes_created} nodes in {time} ms.".format(
+            nodes_created=res.nodes_created,
+            time=res.run_time_ms
+        ))
+
+    def relate_node(self, src, uri, dest):
+
+        print("Create node rel", src, uri, dest)
+
+        res = self.io.query(
+            "MATCH (src:Node {uri: $src}) "
+            "MATCH (dest:Node {uri: $dest}) "
+            "MERGE (src)-[:Rel {uri: $uri}]->(dest)",
+            src=src, dest=dest, uri=uri,
+            database_=self.db,
+        )
+
+        print("Created {nodes_created} nodes in {time} ms.".format(
+            nodes_created=res.nodes_created,
+            time=res.run_time_ms
+        ))
+
+    def relate_literal(self, src, uri, dest):
+
+        print("Create literal rel", src, uri, dest)
+
+        res = self.io.query(
+            "MATCH (src:Node {uri: $src}) "
+            "MATCH (dest:Literal {value: $dest}) "
+            "MERGE (src)-[:Rel {uri: $uri}]->(dest)",
+            src=src, dest=dest, uri=uri,
+            database_=self.db,
+        )
+
+        print("Created {nodes_created} nodes in {time} ms.".format(
+            nodes_created=res.nodes_created,
+            time=res.run_time_ms
+        ))
+
+    def handle(self, msg):
+
+        v = msg.value()
+
+        for t in v.triples:
+
+            self.create_node(t.s.value)
+
+            if t.o.is_uri:
+                self.create_node(t.o.value)
+                self.relate_node(t.s.value, t.p.value, t.o.value)
+            else:
+                self.create_literal(t.o.value)
+                self.relate_literal(t.s.value, t.p.value, t.o.value)
+
+    @staticmethod
+    def add_args(parser):
+
+        Consumer.add_args(
+            parser, default_input_queue, default_subscriber,
+        )
+
+        parser.add_argument(
+            '-g', '--graph_host',
+            default=default_graph_url,
+            help=f'Graph host (default: {default_graph_url})'
+        )
+
+        parser.add_argument(
+            '--database',
+            default=default_database,
+            help=f'FalkorDB database (default: {default_database})'
+        )
+
+def run():
+
+    Processor.start(module, __doc__)
+

trustgraph-flow-0.18.3/trustgraph/storage/triples/neo4j/__init__.py

@@ -0,0 +1,3 @@
+
+from . write import *
+

trustgraph-flow-0.18.3/trustgraph/storage/triples/neo4j/__main__.py

@@ -0,0 +1,7 @@
+#!/usr/bin/env python3
+
+from . write import run
+
+if __name__ == '__main__':
+    run()
+

{trustgraph-flow-0.18.2 → trustgraph-flow-0.18.3}/trustgraph/storage/triples/neo4j/write.py

@@ -1,6 +1,6 @@
 
 """
-Graph writer.  Input is graph edge.  Writes edges to Cassandra graph.
+Graph writer.  Input is graph edge.  Writes edges to Neo4j graph.
 """
 
 import pulsar

{trustgraph-flow-0.18.2 → trustgraph-flow-0.18.3}/trustgraph_flow.egg-info/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.1
 Name: trustgraph-flow
-Version: 0.18.2
+Version: 0.18.3
 Summary: TrustGraph provides a means to run a pipeline of flexible AI processing components in a flexible means to achieve a processing pipeline.
 Home-page: https://github.com/trustgraph-ai/trustgraph
 Author: trustgraph.ai
 Author-email: security@trustgraph.ai
 License: UNKNOWN
-Download-URL: https://github.com/trustgraph-ai/trustgraph/archive/refs/tags/v0.18.2.tar.gz
+Download-URL: https://github.com/trustgraph-ai/trustgraph/archive/refs/tags/v0.18.3.tar.gz
 Platform: UNKNOWN
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)

{trustgraph-flow-0.18.2 → trustgraph-flow-0.18.3}/trustgraph_flow.egg-info/SOURCES.txt

@@ -40,9 +40,11 @@ scripts/text-completion-llamafile
 scripts/text-completion-ollama
 scripts/text-completion-openai
 scripts/triples-query-cassandra
+scripts/triples-query-falkordb
 scripts/triples-query-memgraph
 scripts/triples-query-neo4j
 scripts/triples-write-cassandra
+scripts/triples-write-falkordb
 scripts/triples-write-memgraph
 scripts/triples-write-neo4j
 scripts/wikipedia-lookup
@@ -192,6 +194,9 @@ trustgraph/query/triples/__init__.py
 trustgraph/query/triples/cassandra/__init__.py
 trustgraph/query/triples/cassandra/__main__.py
 trustgraph/query/triples/cassandra/service.py
+trustgraph/query/triples/falkordb/__init__.py
+trustgraph/query/triples/falkordb/__main__.py
+trustgraph/query/triples/falkordb/service.py
 trustgraph/query/triples/memgraph/__init__.py
 trustgraph/query/triples/memgraph/__main__.py
 trustgraph/query/triples/memgraph/service.py
@@ -238,6 +243,9 @@ trustgraph/storage/triples/__init__.py
 trustgraph/storage/triples/cassandra/__init__.py
 trustgraph/storage/triples/cassandra/__main__.py
 trustgraph/storage/triples/cassandra/write.py
+trustgraph/storage/triples/falkordb/__init__.py
+trustgraph/storage/triples/falkordb/__main__.py
+trustgraph/storage/triples/falkordb/write.py
 trustgraph/storage/triples/memgraph/__init__.py
 trustgraph/storage/triples/memgraph/__main__.py
 trustgraph/storage/triples/memgraph/write.py

{trustgraph-flow-0.18.2 → trustgraph-flow-0.18.3}/trustgraph_flow.egg-info/requires.txt

@@ -2,6 +2,7 @@ aiohttp
 anthropic
 cassandra-driver
 cohere
+falkordb
 google-generativeai
 ibis
 jsonschema

trustgraph-flow-0.18.2/trustgraph/flow_version.py

@@ -1 +0,0 @@
-__version__ = "0.18.2"