Cortex

A production-ready full-stack monorepo — NestJS backend with RAG (Retrieval-Augmented Generation) and a Flutter mobile app for notes, POS record management, and AI-powered Q&A.

Architecture

┌──────────────────────────────────────────────────────────────────────┐
│                          Cortex Monorepo                             │
├──────────────────────────────────────────────────────────────────────┤
│                                                                      │
│  ┌─────────────────┐         ┌──────────────────────────────────┐    │
│  │  Flutter App    │  HTTPS  │         NestJS Backend           │    │
│  │  (mobile/)      │◄───────►│         (backend/)               │    │
│  │                 │         │                                  │    │
│  │  • Riverpod     │         │  ┌─────────┐  ┌──────────────┐   │    │
│  │  • Drift SQLite │         │  │  Auth   │  │    Notes     │   │    │
│  │  • Secure Store │         │  │  Module │  │    Module    │   │    │
│  └─────────────────┘         │  └─────────┘  └──────────────┘   │    │
│                              │  ┌─────────┐  ┌──────────────┐   │    │
│                              │  │   POS   │  │  AI / RAG    │   │    │
│                              │  │  Module │  │    Module    │   │    │
│                              │  └─────────┘  └──────────────┘   │    │
│                              │  ┌─────────────────────────────┐ │    │
│                              │  │     Ingestion Worker        │ │    │
│                              │  │  (BullMQ — OCR, chunk,      │ │    │
│                              │  │   embed, upsert vectors)    │ │    │
│                              │  └─────────────────────────────┘ │    │
│                              └───────┬──────────────────────────┘    │
│                                      │                               │
│  ┌────────────┐  ┌─────────┐  ┌──────┴──────┐  ┌───────────────┐     │
│  │ PostgreSQL │  │  Redis  │  │   MinIO     │  │  OpenAI /     │     │
│  │ + pgvector │  │  Queue  │  │ (S3-compat) │  │  Gemini API   │     │
│  └────────────┘  └─────────┘  └─────────────┘  └───────────────┘     │
│                                                                      │
└──────────────────────────────────────────────────────────────────────┘

Repo Structure

cortex/
├── backend/          # NestJS (TypeScript) — REST API + RAG pipeline
├── mobile/           # Flutter (Dart) — cross-platform mobile app
├── docker-compose.yml
├── .env.example
├── .github/workflows/ci.yml
├── docs/
│   └── rag.md
└── README.md

Quick Start

Prerequisites

• Docker & Docker Compose v2
• Node 20 + pnpm 9
• Flutter SDK 3.x

1. Clone & configure

git clone https://github.com/your-org/cortex.git
cd cortex
cp .env.example .env
# Edit .env — set OPENAI_API_KEY (or GEMINI_API_KEY), JWT_SECRET, etc.

2. Start infrastructure

docker compose up -d postgres redis minio

3. Run backend

cd backend
pnpm install
pnpm prisma migrate dev --name init
pnpm prisma db seed
pnpm start:dev

API docs available at http://localhost:3000/api/docs

4. Run the worker (separate terminal)

cd backend
pnpm run start:worker

5. Run the Flutter app

cd mobile
flutter pub get
flutter run

Services

Service	URL	Description
Backend	http://localhost:3000	NestJS REST API
Swagger	http://localhost:3000/api/docs	OpenAPI docs
MinIO	http://localhost:9001	Object storage console
Postgres	localhost:5432	PostgreSQL + pgvector
Redis	localhost:6379	Cache + BullMQ

Privacy-First Architecture

→ Because it is self-hostable with a local PostgreSQL/pgvector instance, your "Second Brain" data is never used to train third-party models. You own your data sovereignty.

License

MIT — see LICENSE.