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.

1.8 KB
Raw Blame
"""
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: Christian Nonis <[email protected]>
-----
"""

import asyncio

from src.services.api.constants.requests import CreateBrainRequest
from src.services.brain_lifecycle import BrainLifecycleService
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


async def create_new_brain(request: CreateBrainRequest):
    """
    Create a new brain
    """
    if not (request.brain_id.isalnum() and request.brain_id[0].isalpha()):
        raise ValueError("brain_id must be alphanumeric and start with a letter")
    result = await asyncio.to_thread(data_adapter.create_brain, request.brain_id)
    return result


def get_brain_lifecycle_service() -> BrainLifecycleService:
    # Import lazily so lightweight system-route tests do not initialize every
    # configured storage client before a lifecycle operation is requested.
    from src.core.instances import (
        cache_adapter,
        graph_adapter,
        vector_store_adapter,
    )

    return BrainLifecycleService(
        data_client=data_adapter.data,
        graph_client=graph_adapter.graph,
        vector_client=vector_store_adapter.vector_store,
        cache_client=cache_adapter.cache,
    )


async def clear_brain(brain_id: str, service: BrainLifecycleService):
    result = await asyncio.to_thread(service.clear, brain_id)
    return result.as_dict()


async def delete_brain(brain_id: str, service: BrainLifecycleService):
    result = await asyncio.to_thread(service.delete, brain_id)
    return result.as_dict()