> ## Documentation Index
> Fetch the complete documentation index at: https://project-brain.rocheaiops.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Architecture overview

> The accepted Phase 6 application, provider, development-memory, and recovery boundaries.

PROJECT B.R.A.I.N. is a Python/FastAPI modular monolith with PostgreSQL +
pgvector, portable artifacts, and a bounded worker. It is deliberately not a
distributed graph system or a collection of provider-owned memories.

<a href="/assets/visuals/brain-system-context.svg" target="_blank" rel="noreferrer" aria-label="Open full-size diagram: Current architecture"><img src="https://mintcdn.com/roche-ai-ops/zV65QLx2v4-e7KNO/assets/visuals/brain-system-context.svg?fit=max&auto=format&n=zV65QLx2v4-e7KNO&q=85&s=a009613b7ea420e14818da8962b09e93" alt="Current architecture" noZoom width="1440" height="820" data-path="assets/visuals/brain-system-context.svg" /><span className="sr-only">Open full-size diagram: Current architecture</span></a>

| Boundary              | Current role                                                                   |
| --------------------- | ------------------------------------------------------------------------------ |
| Conversation Gateway  | Normalizes text and Live interaction into durable events.                      |
| FastAPI/API           | Authenticated private application edge.                                        |
| PostgreSQL + pgvector | Structured canonical state and provisioned vector capability.                  |
| Artifact filesystem   | Original and normalized document representations.                              |
| Worker                | Bounded durable jobs for consolidation and document work.                      |
| Gemini                | Replaceable reasoning, Live, and embedding provider.                           |
| Doppler               | Scoped server-side secret delivery.                                            |
| Basic Memory          | Separate developer-memory Compose deployment; never an application dependency. |

<Note>**Current retrieval path:** pgvector is provisioned, but it is not currently the nearest-neighbor query path. The current document corpus uses compatible stored vectors and cosine ranking in application code.</Note>

See [storage](/architecture/storage) and [provider boundaries](/architecture/provider-boundaries).