Skip to content

BrainAPI is a knowledge graph–powered AI memory layer that transforms unstructured data into structured knowledge, enabling intelligent search, recommendations, and contextual memory for AI agents and applications.

feat(misc): service routes + old misc

Christianb0a482c71068
diff --git a/README.md b/README.md
index da448a1..bc73877 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,5 @@
+BEFORE OPEN SOURCING REMOVE PAT AND ALL SECRETS
+
## New deploy config
```
diff --git a/pyproject.toml b/pyproject.toml
index 84b9e13..021e4f4 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "brainapi2"
-version = "1.2.0-dev"
+version = "1.2.1-dev"
description = "Version 1.x.x of the BrainAPI memory layer."
authors = [
{name = "Christian",email = "[email protected]"}
diff --git a/src/adapters/graph.py b/src/adapters/graph.py
index 4fe9ed6..bb093ba 100644
--- a/src/adapters/graph.py
+++ b/src/adapters/graph.py
@@ -56,8 +56,8 @@ class GraphAdapter:
def add_nodes(
self,
nodes: list[Node],
- identification_params: Optional[dict],
- metadata: Optional[dict],
+ identification_params: Optional[dict] = None,
+ metadata: Optional[dict] = None,
database: Optional[str] = None,
) -> list[Node] | str:
"""
@@ -190,5 +190,17 @@ class GraphAdapter:
node=node, uuids=uuids, limit=limit, with_labels=with_labels
)
+ def search_relationships(self, limit: int = 10, skip: int = 0) -> list[Triple]:
+ """
+ Search the relationships of the graph.
+ """
+ return self.graph.search_relationships(limit, skip)
+
+ def search_entities(self, limit: int = 10, skip: int = 0) -> list[Node]:
+ """
+ Search the entities of the graph.
+ """
+ return self.graph.search_entities(limit, skip)
+
_graph_adapter = GraphAdapter()
diff --git a/src/adapters/interfaces/graph.py b/src/adapters/interfaces/graph.py
index 37c3688..e82d507 100644
--- a/src/adapters/interfaces/graph.py
+++ b/src/adapters/interfaces/graph.py
@@ -46,8 +46,8 @@ class GraphClient(ABC):
def add_nodes(
self,
nodes: list[Node],
- identification_params: Optional[dict],
- metadata: Optional[dict],
+ identification_params: Optional[dict] = None,
+ metadata: Optional[dict] = None,
database: Optional[str] = None,
) -> list[Node] | str:
"""
@@ -194,3 +194,16 @@ class GraphClient(ABC):
Get the connected nodes by their UUIDs.
"""
raise NotImplementedError("get_connected_nodes method not implemented")
+
+ @abstractmethod
+ def search_relationships(self, limit: int = 10, skip: int = 0) -> list[Triple]:
+ """
+ Search the relationships of the graph.
+ """
+ raise NotImplementedError("search_relationships method not implemented")
+
+ @abstractmethod
+ def search_entities(self, limit: int = 10, skip: int = 0) -> list[Node]:
+ """
+ Search the entities of the graph.
+ """
diff --git a/src/constants/kg.py b/src/constants/kg.py
index db9f1c5..7fe58be 100644
--- a/src/constants/kg.py
+++ b/src/constants/kg.py
@@ -11,7 +11,7 @@ Modified By: the developer formerly known as Christian Nonis at <alch.infoemail@
from datetime import datetime
from typing import List, Literal, Optional
import uuid
-from pydantic import BaseModel, Extra, Field
+from pydantic import BaseModel, ConfigDict, Extra, Field
from src.constants.data import Observation
@@ -110,9 +110,4 @@ class IdentificationParams(BaseModel):
description="The types of the entity to identify.",
)
- class Meta:
- """
- Allow extra properties to be added to the identification params.
- """
-
- extra = Extra.allow
+ model_config = ConfigDict(extra="allow")
diff --git a/src/core/agents/kg_agent.py b/src/core/agents/kg_agent.py
index 9f0020d..0744c33 100644
--- a/src/core/agents/kg_agent.py
+++ b/src/core/agents/kg_agent.py
@@ -187,10 +187,6 @@ class KGAgent:
graph_db_relationships = self.kg.get_graph_relationships()
graph_db_entities = self.kg.get_graph_entities()
- print("[graph_db_prop_keys]", graph_db_prop_keys)
- print("[graph_db_relationships]", graph_db_relationships)
- print("[graph_db_entities]", graph_db_entities)
-
extra_system_prompt_str = f"""
The following are the information and schemas about the db, you must only use the following information to operate with the db:
{{
diff --git a/src/core/agents/tools/kg_agent/KGAgentAddTripletsTool.py b/src/core/agents/tools/kg_agent/KGAgentAddTripletsTool.py
index ff59407..8a5b4b0 100644
--- a/src/core/agents/tools/kg_agent/KGAgentAddTripletsTool.py
+++ b/src/core/agents/tools/kg_agent/KGAgentAddTripletsTool.py
@@ -81,7 +81,7 @@ class KGAgentAddTripletsTool(BaseTool):
v_sim_sub = self.vector_store.search_vectors(v_sub.embeddings, "nodes", k=5)
v_sim_obj = self.vector_store.search_vectors(v_obj.embeddings, "nodes", k=5)
- print("[v_sim_x]", v_sim_sub, v_sim_obj)
+
sim_sub = most_similar_name_with_labels_or_none(
subject.name,
[v.metadata.get("name", []) for v in v_sim_sub],
@@ -94,13 +94,11 @@ class KGAgentAddTripletsTool(BaseTool):
object_node.labels,
[v.metadata.get("labels", []) for v in v_sim_obj],
)
- print("[sim_x]", sim_sub, sim_obj)
if sim_sub:
sim_sub_vector = next(
(v for v in v_sim_sub if v.metadata.get("name", []) == sim_sub),
None,
)
- print("[sim_sub_vector]", sim_sub_vector)
subject = Node(
name=sim_sub_vector.metadata.get("name", []),
uuid=sim_sub_vector.metadata.get("uuid"),
@@ -121,7 +119,7 @@ class KGAgentAddTripletsTool(BaseTool):
(v for v in v_sim_obj if v.metadata.get("name", []) == sim_obj),
None,
)
- print("[sim_obj_vector]", sim_obj_vector)
+
object_node = Node(
name=sim_obj_vector.metadata.get("name", []),
uuid=sim_obj_vector.metadata.get("uuid"),
@@ -156,8 +154,7 @@ class KGAgentAddTripletsTool(BaseTool):
self.kg.add_nodes(
[triplet.subject, triplet.object],
- self.identification_params,
- self.metadata,
+ metadata=self.metadata,
)
self.kg.add_relationship(
triplet.subject,
diff --git a/src/core/instances.py b/src/core/instances.py
new file mode 100644
index 0000000..b1988be
--- /dev/null
+++ b/src/core/instances.py
@@ -0,0 +1,9 @@
+"""
+File: /instances.py
+Created Date: Friday November 7th 2025
+Author: Christian Nonis <[email protected]>
+-----
+Last Modified: Friday November 7th 2025 8:35:34 pm
+Modified By: the developer formerly known as Christian Nonis at <[email protected]>
+-----
+"""
diff --git a/src/core/search/__init__.py b/src/core/search/__init__.py
new file mode 100644
index 0000000..a1861fd
--- /dev/null
+++ b/src/core/search/__init__.py
@@ -0,0 +1,9 @@
+"""
+File: /__init__.py
+Created Date: Friday November 7th 2025
+Author: Christian Nonis <[email protected]>
+-----
+Last Modified: Friday November 7th 2025 8:12:51 pm
+Modified By: the developer formerly known as Christian Nonis at <[email protected]>
+-----
+"""
diff --git a/src/core/search/entities.py b/src/core/search/entities.py
new file mode 100644
index 0000000..2667d17
--- /dev/null
+++ b/src/core/search/entities.py
@@ -0,0 +1,20 @@
+"""
+File: /entities.py
+Created Date: Friday November 7th 2025
+Author: Christian Nonis <[email protected]>
+-----
+Last Modified: Friday November 7th 2025 8:13:02 pm
+Modified By: the developer formerly known as Christian Nonis at <[email protected]>
+-----
+"""
+
+from src.constants.kg import Node
+from src.services.kg_agent.main import graph_adapter
+
+
+def search_entities(limit: int = 10, skip: int = 0) -> list[Node]:
+ """
+ Search the entities of the graph.
+ """
+ result = graph_adapter.search_entities(limit, skip)
+ return result
diff --git a/src/core/search/relationships.py b/src/core/search/relationships.py
new file mode 100644
index 0000000..622d892
--- /dev/null
+++ b/src/core/search/relationships.py
@@ -0,0 +1,20 @@
+"""
+File: /relationships.py
+Created Date: Friday November 7th 2025
+Author: Christian Nonis <[email protected]>
+-----
+Last Modified: Friday November 7th 2025 8:12:57 pm
+Modified By: the developer formerly known as Christian Nonis at <[email protected]>
+-----
+"""
+
+from src.constants.kg import Triple
+from src.services.kg_agent.main import graph_adapter
+
+
+def search_relationships(limit: int = 10, skip: int = 0) -> list[Triple]:
+ """
+ Search the relationships of the graph.
+ """
+ result = graph_adapter.search_relationships(limit, skip)
+ return result
diff --git a/src/lib/neo4j/client.py b/src/lib/neo4j/client.py
index c61841d..10f10e8 100644
--- a/src/lib/neo4j/client.py
+++ b/src/lib/neo4j/client.py
@@ -9,11 +9,12 @@ Modified By: the developer formerly known as Christian Nonis at <alch.infoemail@
"""
import os
-from typing import Optional, Tuple
+from typing import Any, Optional, Tuple
from neo4j import GraphDatabase
from src.adapters.interfaces.graph import GraphClient
from src.config import config
-from src.constants.kg import IdentificationParams, Node, Predicate
+from src.constants.kg import IdentificationParams, Node, Predicate, Triple
+from src.utils.logging import log
class Neo4jClient(GraphClient):
@@ -84,11 +85,38 @@ class Neo4jClient(GraphClient):
words = property_key.split()
return "".join(word.capitalize() for word in words)
+ def _format_property_key(self, property_key: str) -> str:
+ """
+ Format a property key for use in a Cypher query, including sanitization and quoting.
+ """
+ sanitized_key = property_key.rstrip("`").lstrip("`")
+ needs_quoting = any(
+ char in sanitized_key
+ for char in ["-", " ", ".", "+", "*", "/", "%", ":", "@", "#", "$"]
+ )
+ cleaned_key = self._clean_property_key(sanitized_key)
+ return f"`{cleaned_key}`" if needs_quoting else cleaned_key
+
+ def _format_value(self, value: Any) -> str:
+ """
+ Format a value for use in a Cypher query, including sanitization and quoting.
+ """
+ if isinstance(value, str):
+ v = value.replace("'", "\\'")
+ return f"'{v}'"
+ elif isinstance(value, (int, float, bool)):
+ return str(value)
+ elif value is None:
+ return "null"
+ else:
+ v = str(value).replace("'", "\\'")
+ return f"'{v}'"
+
def add_nodes(
self,
nodes: list[Node],
- identification_params: dict,
- metadata: dict,
+ identification_params: Optional[dict] = None,
+ metadata: Optional[dict] = None,
database: Optional[str] = None,
) -> list[Node] | str:
"""
@@ -96,39 +124,55 @@ class Neo4jClient(GraphClient):
"""
results = []
for node in nodes:
- identification_set = f"{{name: '{node.name}'}}"
+ identification_dict = {"Name": node.name}
all_properties = {
**(node.properties or {}),
**(metadata or {}),
}
+ if identification_params:
+ for key, value in identification_params.items():
+ identification_dict[key] = value
+
+ identification_items = []
+ for key, value in identification_dict.items():
+ cypher_key = self._format_property_key(key)
+
+ if isinstance(value, str):
+ escaped_value = self._format_value(value)
+ identification_items.append(f"{cypher_key}: {escaped_value}")
+ elif isinstance(value, (int, float, bool)):
+ identification_items.append(
+ f"{cypher_key}: {self._format_value(value)}"
+ )
+ elif value is None:
+ identification_items.append(f"{cypher_key}: null")
+ else:
+ escaped_value = self._format_value(value)
+ identification_items.append(f"{cypher_key}: {escaped_value}")
+
+ identification_set_str = f"{{{', '.join(identification_items)}}}"
+
if node.description is not None:
all_properties["description"] = node.description
property_assignments = []
for key, value in all_properties.items():
- sanitized_key = key.rstrip("`").lstrip("`")
- needs_quoting = any(
- char in sanitized_key
- for char in ["-", " ", ".", "+", "*", "/", "%", ":", "@", "#", "$"]
- )
- cypher_key = (
- f"`{self._clean_property_key(sanitized_key)}`"
- if needs_quoting
- else self._clean_property_key(sanitized_key)
- )
+ cypher_key = self._format_property_key(key)
if isinstance(value, str):
- escaped_value = value.replace("'", "\\'")
- property_assignments.append(f"n.{cypher_key} = '{escaped_value}'")
+ escaped_value = self._format_value(value)
+ property_assignments.append(f"n.{cypher_key} = {escaped_value}")
elif isinstance(value, (int, float, bool)):
- property_assignments.append(f"n.{cypher_key} = {value}")
+ property_assignments.append(
+ f"n.{cypher_key} = {self._format_value(value)}"
+ )
elif value is None:
property_assignments.append(f"n.{cypher_key} = null")
else:
- escaped_value = str(value).replace("'", "\\'")
- property_assignments.append(f"n.{cypher_key} = '{escaped_value}'")
+ escaped_value = self._format_value(value)
+ property_assignments.append(f"n.{cypher_key} = {escaped_value}")
property_assignments.append(f"n.uuid = '{node.uuid}'")
@@ -136,13 +180,18 @@ class Neo4jClient(GraphClient):
labels_expression = ":".join(self._clean_labels(node.labels))
cypher_query = f"""
- MERGE (n:{labels_expression} {identification_set})
+ MERGE (n:{labels_expression} {identification_set_str})
SET {properties_set}
RETURN n
"""
self.ensure_database(database)
- result = self.driver.execute_query(cypher_query, database_=database)
- results.append(result)
+ try:
+ result = self.driver.execute_query(cypher_query, database_=database)
+ results.append(result)
+ log("Nodes added: ", results)
+ except Exception as e:
+ print(f"Error adding node: {e} - {cypher_query}")
+ raise
return [
Node(
@@ -167,9 +216,9 @@ class Neo4jClient(GraphClient):
safe_desc = predicate.description.replace("'", "\\'")
cypher_query = f"""
- MATCH (a:{":".join(self._clean_labels(subject.labels))}) WHERE a.name = '{subject.name}'
- MATCH (b:{":".join(self._clean_labels(to_object.labels))}) WHERE b.name = '{to_object.name}'
- CREATE (a)-[:{":".join(self._clean_labels([predicate.name]))} {{ description: '{safe_desc}' }}]->(b)
+ MATCH (a:{":".join(self._clean_labels(subject.labels))}) WHERE a.Name = '{subject.name}'
+ MATCH (b:{":".join(self._clean_labels(to_object.labels))}) WHERE b.Name = '{to_object.name}'
+ CREATE (a)-[:{":".join(self._clean_labels([predicate.name]))} {{ Description: '{safe_desc}' }}]->(b)
RETURN a, b
"""
result = self.driver.execute_query(cypher_query)
@@ -184,7 +233,7 @@ class Neo4jClient(GraphClient):
queries = []
for node in nodes:
- query = f"""MATCH (n:{":".join(self._clean_labels(node.labels))}) WHERE n.name = '{node.name}'
+ query = f"""MATCH (n:{":".join(self._clean_labels(node.labels))}) WHERE n.Name = '{node.name}'
OPTIONAL MATCH (n)-[r*1]-(m)
RETURN n, r, m"""
queries.append(query)
@@ -199,8 +248,8 @@ class Neo4jClient(GraphClient):
"""
cypher_query = f"""
MATCH (n)
- WHERE toLower(n.name) CONTAINS toLower('{text}')
- RETURN n.uuid as uuid, n.name as name, labels(n) as labels, n.description as description, properties(n) as properties
+ WHERE toLower(n.Name) CONTAINS toLower('{text}')
+ RETURN n
"""
result = self.driver.execute_query(cypher_query)
return [
@@ -410,7 +459,7 @@ class Neo4jClient(GraphClient):
"""
Get the neighbors of a node.
"""
- print("[node]", node.uuid, node.labels)
+
cypher_query = f"""
MATCH (n {{uuid: '{node.uuid}'}})-[r]-(c)-[r2]-(m)
WHERE size([l IN labels(n) WHERE l IN labels(m)]) > 0
@@ -601,5 +650,141 @@ class Neo4jClient(GraphClient):
for record in result.records
]
+ def search_relationships(self, limit: int = 10, skip: int = 0) -> list[Triple]:
+ """
+ Search the relationships of the graph.
+ """
+ cypher_query = f"""
+ MATCH (n)-[r]-(m)
+ RETURN n.uuid as n_uuid, n.name as n_name, labels(n) as n_labels, n.description as n_description, properties(n) as n_properties,
+ r as rel, type(r) as rel_type, r.description as rel_description,
+ m.uuid as m_uuid, m.name as m_name, labels(m) as m_labels, m.description as m_description, properties(m) as m_properties
+ SKIP {skip}
+ LIMIT {limit}
+ """
+ result = self.driver.execute_query(cypher_query)
+ triples: list[Triple] = []
+ for record in result.records:
+ relationship = record.get("rel")
+ if relationship is None:
+ continue
+ subject_properties = dict(record.get("n_properties") or {})
+ object_properties = dict(record.get("m_properties") or {})
+ relationship_properties = dict(relationship)
+ subject_uuid = record.get("n_uuid") or subject_properties.get("uuid")
+ object_uuid = record.get("m_uuid") or object_properties.get("uuid")
+ subject_name = (
+ record.get("n_name")
+ or subject_properties.get("name")
+ or subject_properties.get("Name")
+ or subject_uuid
+ )
+ object_name = (
+ record.get("m_name")
+ or object_properties.get("name")
+ or object_properties.get("Name")
+ or object_uuid
+ )
+ subject_description = (
+ record.get("n_description")
+ or subject_properties.get("description")
+ or subject_properties.get("Description")
+ )
+ object_description = (
+ record.get("m_description")
+ or object_properties.get("description")
+ or object_properties.get("Description")
+ )
+ subject_labels = (
+ record.get("n_labels") or subject_properties.get("labels") or []
+ )
+ object_labels = (
+ record.get("m_labels") or object_properties.get("labels") or []
+ )
+ relationship_type = record.get("rel_type") or relationship.type
+ relationship_description = (
+ record.get("rel_description")
+ or relationship_properties.get("description")
+ or relationship_properties.get("Description")
+ )
+ subject_uuid_value = subject_uuid or str(relationship.start_node.element_id)
+ object_uuid_value = object_uuid or str(relationship.end_node.element_id)
+ subject_name_value = subject_name or subject_uuid_value
+ object_name_value = object_name or object_uuid_value
+ start_uuid = (
+ relationship.start_node.get("uuid")
+ if "uuid" in relationship.start_node
+ else str(relationship.start_node.element_id)
+ )
+ direction = "out"
+ if str(subject_uuid_value) != str(start_uuid):
+ direction = "in"
+ triples.append(
+ Triple(
+ subject=Node(
+ uuid=str(subject_uuid_value),
+ name=str(subject_name_value),
+ labels=list(subject_labels),
+ description=subject_description,
+ properties=subject_properties,
+ ),
+ predicate=Predicate(
+ name=str(relationship_type),
+ description=relationship_description or "",
+ direction=direction,
+ observations=None,
+ level=None,
+ deprecated=relationship_properties.get("deprecated", False),
+ ),
+ object=Node(
+ uuid=str(object_uuid_value),
+ name=str(object_name_value),
+ labels=list(object_labels),
+ description=object_description,
+ properties=object_properties,
+ ),
+ )
+ )
+ return triples
+
+ def search_entities(self, limit: int = 10, skip: int = 0) -> list[Node]:
+ """
+ Search the entities of the graph.
+ """
+ cypher_query = f"""
+ MATCH (n)
+ RETURN n.uuid as uuid, n.name as name, labels(n) as labels, n.description as description, properties(n) as properties
+ SKIP {skip}
+ LIMIT {limit}
+ """
+ result = self.driver.execute_query(cypher_query)
+ nodes: list[Node] = []
+ for record in result.records:
+ properties_record = record.get("properties") or {}
+ name = (
+ record.get("name")
+ or properties_record.get("name")
+ or properties_record.get("Name")
+ or record.get("uuid")
+ )
+ description = (
+ record.get("description")
+ or properties_record.get("description")
+ or properties_record.get("Description")
+ )
+ uuid = record.get("uuid") or properties_record.get("uuid") or name
+ labels = record.get("labels") or properties_record.get("labels") or []
+ properties = dict(properties_record)
+ nodes.append(
+ Node(
+ uuid=str(uuid),
+ name=str(name) if name is not None else str(uuid),
+ labels=list(labels),
+ description=description,
+ properties=properties,
+ )
+ )
+ return nodes
+
_neo4j_client = Neo4jClient()
diff --git a/src/services/api/app.py b/src/services/api/app.py
index a13030d..f811acb 100644
--- a/src/services/api/app.py
+++ b/src/services/api/app.py
@@ -15,11 +15,13 @@ from uvicorn import run
from src.services.api.routes.ingest import ingest_router
from src.services.api.routes.retrieve import retrieve_router
+from src.services.api.routes.meta import meta_router
app = FastAPI()
app.include_router(ingest_router)
app.include_router(retrieve_router)
+app.include_router(meta_router)
if __name__ == "__main__":
run(app, host="0.0.0.0", port=8000, reload=os.getenv("ENV") == "development")
diff --git a/src/services/api/controllers/meta.py b/src/services/api/controllers/meta.py
new file mode 100644
index 0000000..91583d8
--- /dev/null
+++ b/src/services/api/controllers/meta.py
@@ -0,0 +1,20 @@
+"""
+File: /meta.py
+Created Date: Friday November 7th 2025
+Author: Christian Nonis <[email protected]>
+-----
+Last Modified: Friday November 7th 2025 9:59:06 pm
+Modified By: the developer formerly known as Christian Nonis at <[email protected]>
+-----
+"""
+
+import asyncio
+from src.services.kg_agent.main import graph_adapter
+
+
+async def get_entity_properties():
+ """
+ Get the entity properties of the graph.
+ """
+ result = await asyncio.to_thread(graph_adapter.get_graph_property_keys)
+ return result
diff --git a/src/services/api/controllers/retrieve.py b/src/services/api/controllers/retrieve.py
index 9369fe9..ecff7c6 100644
--- a/src/services/api/controllers/retrieve.py
+++ b/src/services/api/controllers/retrieve.py
@@ -13,8 +13,11 @@ import time
from typing import List, Optional
from fastapi import HTTPException
+from starlette.responses import JSONResponse
from src.constants.kg import IdentificationParams, Node, Predicate, Relationship
+from src.core.search.entities import search_entities
+from src.core.search.relationships import search_relationships
from src.services.api.constants.requests import (
RetrieveRequestResponse,
RetrieveNeighborsRequestResponse,
@@ -311,3 +314,31 @@ async def retrieve_neighbors_ai_mode(
result = await asyncio.to_thread(_get_neighbors)
return result
+
+
+async def get_relationships(limit: int = 10, skip: int = 0):
+ """
+ Get the relationships of the graph.
+ """
+ relationships = await asyncio.to_thread(search_relationships, limit, skip)
+
+ return JSONResponse(
+ content={
+ "message": "Relationships retrieved successfully",
+ "relationships": [r.model_dump(mode="json") for r in relationships],
+ }
+ )
+
+
+async def get_entities(limit: int = 10, skip: int = 0):
+ """
+ Get the entities of the graph.
+ """
+ entities = await asyncio.to_thread(search_entities, limit, skip)
+
+ return JSONResponse(
+ content={
+ "message": "Entities retrieved successfully",
+ "entities": [e.model_dump(mode="json") for e in entities],
+ }
+ )
diff --git a/src/services/api/routes/ingest.py b/src/services/api/routes/ingest.py
index c3fc811..1838fe7 100644
--- a/src/services/api/routes/ingest.py
+++ b/src/services/api/routes/ingest.py
@@ -28,7 +28,6 @@ async def ingest_data(data: IngestionRequestBody):
"""
Ingest data to the processing pipeline and save to the memory.
"""
-
task = ingest_data_task.delay(data.model_dump())
return JSONResponse(
@@ -41,7 +40,7 @@ async def ingest_structured_data(data: IngestionStructuredRequestBody):
"""
Ingest structured data to the processing pipeline and save to the memory.
"""
-
+ print("[data]", data)
task = ingest_structured_data_task.delay(data.model_dump())
return JSONResponse(
diff --git a/src/services/api/routes/meta.py b/src/services/api/routes/meta.py
new file mode 100644
index 0000000..e493df3
--- /dev/null
+++ b/src/services/api/routes/meta.py
@@ -0,0 +1,25 @@
+"""
+File: /meta.py
+Created Date: Friday November 7th 2025
+Author: Christian Nonis <[email protected]>
+-----
+Last Modified: Friday November 7th 2025 9:58:46 pm
+Modified By: the developer formerly known as Christian Nonis at <[email protected]>
+-----
+"""
+
+from fastapi import APIRouter
+
+from src.services.api.controllers.meta import (
+ get_entity_properties as get_entity_properties_controller,
+)
+
+meta_router = APIRouter(prefix="/meta", tags=["meta"])
+
+
+@meta_router.get(path="/entity-properties")
+async def get_entity_properties():
+ """
+ Get the entity properties of the graph.
+ """
+ return await get_entity_properties_controller()
diff --git a/src/services/api/routes/retrieve.py b/src/services/api/routes/retrieve.py
index e8d3bc1..691f1df 100644
--- a/src/services/api/routes/retrieve.py
+++ b/src/services/api/routes/retrieve.py
@@ -8,7 +8,6 @@ Modified By: the developer formerly known as Christian Nonis at <alch.infoemail@
-----
"""
-from typing import Optional
from fastapi import APIRouter, Body, Query
from src.services.api.constants.requests import (
@@ -20,6 +19,8 @@ from src.services.api.constants.requests import (
from src.services.api.controllers.retrieve import (
retrieve_neighbors as retrieve_neighbors_controller,
retrieve_neighbors_ai_mode as retrieve_neighbors_ai_mode_controller,
+ get_relationships as retrieve_get_relationships_controller,
+ get_entities as retrieve_get_entities_controller,
)
from src.services.api.controllers.retrieve import (
retrieve_data as retrieve_data_controller,
@@ -90,3 +91,19 @@ async def get_context(request):
"""
Get the context of an entity.
"""
+
+
+@retrieve_router.get(path="/relationships")
+async def get_relationships(limit: int = 10, skip: int = 0):
+ """
+ Get the relationships of the graph.
+ """
+ return await retrieve_get_relationships_controller(limit, skip)
+
+
+@retrieve_router.get(path="/entities")
+async def get_entities(limit: int = 10, skip: int = 0):
+ """
+ Get the entities of the graph.
+ """
+ return await retrieve_get_entities_controller(limit, skip)
diff --git a/src/utils/nlp/names.py b/src/utils/nlp/names.py
index 0e06ac6..03a8a06 100644
--- a/src/utils/nlp/names.py
+++ b/src/utils/nlp/names.py
@@ -63,9 +63,6 @@ def most_similar_name_with_labels_or_none(
most_similar_name, max_similarity = find_most_similar_names(
name, names, labels_a, labels_list
)
- print(
- f"[SIMILARITY] {max_similarity} for {name} w/ labels {labels_a} and {most_similar_name} w/ labels {labels_list}"
- )
if max_similarity > 0.75:
return most_similar_name
return None
diff --git a/src/workers/tasks/ingestion.py b/src/workers/tasks/ingestion.py
index bb86fb5..2bfffdd 100644
--- a/src/workers/tasks/ingestion.py
+++ b/src/workers/tasks/ingestion.py
@@ -89,7 +89,7 @@ def ingest_data(self, args: dict):
),
observate_for=payload.observate_for,
)
- print("[observations]", observations, type(observations))
+
data_adapter.save_observations(
[
Observation(
@@ -132,7 +132,6 @@ def ingest_structured_data(self, args: dict):
for element in payload.data:
uuid = str(uuid4())
- print("[uuid]", uuid)
node = graph_adapter.add_nodes(
[
Node(
@@ -149,7 +148,7 @@ def ingest_structured_data(self, args: dict):
},
)
],
- identification_params=element.identification_params,
+ identification_params=element.identification_params.model_dump(mode="json"),
metadata=element.textual_data,
)[0]
vector = embeddings_adapter.embed_text(node.name)