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(brains): api to get all brains

Christian0a696178b441
diff --git a/src/adapters/data.py b/src/adapters/data.py
index 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.py
index 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.py
index 03cb9c5..1c2a394 100644
--- a/src/lib/mongo/client.py
+++ b/src/lib/mongo/client.py
@@ -144,5 +144,13 @@ class MongoClient(DataClient):
return None
return 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.py
index 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 BrainMiddleware
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
+from src.services.api.routes.system import system_router
app = 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.py
new file mode 100644
index 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 result
diff --git a/src/services/api/middlewares/brains.py b/src/services/api/middlewares/brains.py
index 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.py
new file mode 100644
index 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()