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.
Python ai-agentsai-memoryknowledge-graphknowledge-managementknowledge-representationreccomendation-system
feat(brains): api to get all brains
Christian0a696178b441
diff --git a/src/adapters/data.py b/src/adapters/data.pyindex e781da8..b1dbcc0 100644--- a/src/adapters/data.py+++ b/src/adapters/data.py@@ -76,3 +76,9 @@ class DataAdapter:Get a brain from the data client."""return self.data.get_brain(name_key)++ def get_brains_list(self) -> List[Brain]:+ """+ Get the list of brains from the data client.+ """+ return self.data.get_brains_list()diff --git a/src/adapters/interfaces/data.py b/src/adapters/interfaces/data.pyindex 4102a42..3b070c1 100644--- a/src/adapters/interfaces/data.py+++ b/src/adapters/interfaces/data.py@@ -84,3 +84,10 @@ class DataClient(ABC):Get a brain from the data client."""raise NotImplementedError("get_brain method not implemented")++ @abstractmethod+ def get_brains_list(self) -> List[Brain]:+ """+ Get the list of brains from the data client.+ """+ raise NotImplementedError("get_brains_list method not implemented")diff --git a/src/lib/mongo/client.py b/src/lib/mongo/client.pyindex 03cb9c5..1c2a394 100644--- a/src/lib/mongo/client.py+++ b/src/lib/mongo/client.py@@ -144,5 +144,13 @@ class MongoClient(DataClient):return Nonereturn Brain(id=str(result["_id"]), name_key=result["name_key"])+ def get_brains_list(self) -> List[Brain]:+ collection = self.get_collection("brains", "system")+ result = collection.find()+ return [+ Brain(id=str(result["_id"]), name_key=result["name_key"])+ for result in result+ ]+_mongo_client = MongoClient()diff --git a/src/services/api/app.py b/src/services/api/app.pyindex 3e54ad0..6da442c 100644--- a/src/services/api/app.py+++ b/src/services/api/app.py@@ -19,6 +19,7 @@ from src.services.api.middlewares.brains import BrainMiddlewarefrom src.services.api.routes.ingest import ingest_routerfrom src.services.api.routes.retrieve import retrieve_routerfrom src.services.api.routes.meta import meta_router+from src.services.api.routes.system import system_routerapp = FastAPI()@@ -36,6 +37,7 @@ app.add_middleware(BrainMiddleware)app.include_router(ingest_router)app.include_router(retrieve_router)app.include_router(meta_router)+app.include_router(system_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/system.py b/src/services/api/controllers/system.pynew file mode 100644index 0000000..7e2c159--- /dev/null+++ b/src/services/api/controllers/system.py@@ -0,0 +1,20 @@+"""+File: /system.py+Created Date: Monday December 1st 2025+Author: Christian Nonis <[email protected]>+-----+Last Modified: Monday December 1st 2025 10:13:27 pm+Modified By: the developer formerly known as Christian Nonis at <[email protected]>+-----+"""++import asyncio+from src.services.data.main import data_adapter+++async def get_brains_list():+ """+ Get the list of brains.+ """+ result = await asyncio.to_thread(data_adapter.get_brains_list)+ return resultdiff --git a/src/services/api/middlewares/brains.py b/src/services/api/middlewares/brains.pyindex fc55fb5..7c45a53 100644--- a/src/services/api/middlewares/brains.py+++ b/src/services/api/middlewares/brains.py@@ -51,7 +51,7 @@ class BrainMiddleware(BaseHTTPMiddleware):status_code=status.HTTP_400_BAD_REQUEST,content={"detail": "System brain is not allowed to be used."},)- if not brain_id.isalnum():+ if brain_id and not brain_id.isalnum():return JSONResponse(status_code=status.HTTP_400_BAD_REQUEST,content={"detail": "Brain ID must be alphanumeric."},diff --git a/src/services/api/routes/system.py b/src/services/api/routes/system.pynew file mode 100644index 0000000..f133078--- /dev/null+++ b/src/services/api/routes/system.py@@ -0,0 +1,24 @@+"""+File: /system.py+Created Date: Monday December 1st 2025+Author: Christian Nonis <[email protected]>+-----+Last Modified: Monday December 1st 2025 10:12:48 pm+Modified By: the developer formerly known as Christian Nonis at <[email protected]>+-----+"""++from fastapi import APIRouter+from src.services.api.controllers.system import (+ get_brains_list as get_brains_list_controller,+)++system_router = APIRouter(prefix="/system", tags=["system"])+++@system_router.get(path="/brains-list")+async def get_brains_list():+ """+ Get the list of brains.+ """+ return await get_brains_list_controller()