Repository Catalog

This is the map of which repository to open for a given task. Repos are grouped by purpose; within a group, note where a repo has a Databricks and a Snowflake variant — those are parallel implementations of the same responsibility on different data platforms. All repos live under the dataready-ai GitHub org. For how they connect, see the cross-repo map.

Note

This lists the primary repos an engineer touches for the core platform. It is not exhaustive of every repo in the org (there are additional templates, test copies, demo repos, and experiments). When a repo has a name like *-template or *-test, treat it as a scaffold or test copy of its base repo, not a source of truth.

Product & gateway

The customer-facing surface. These two are shared across both data platforms.

Repository	Stack	Purpose
nexa-web	React 18 + Vite (JS)	The single-page UI for the whole platform. Calls only /api/*.
nexa-backend	Node/TypeScript, Express 4	The API gateway. Owns all web-domain data (Postgres web) and proxies compute to the FastAPI services.

Data-platform APIs

The control/data plane for the customer’s warehouse. One repo per data platform.

Repository	Data platform	Stack	Purpose
nexa-databricks-api	Databricks	FastAPI (Poetry)	Catalog, connectors, pipelines, jobs, warehouses, deployments, lineage, codegen. Served at /platform.
nexa-snowflake-api	Snowflake	FastAPI (uv)	Snowflake twin — objects, warehouses, tasks/streams/dynamic tables, usage, lineage.

Agents & automations

The control plane that manages agent/automation lifecycle plus the Git-driven runtime that executes them.

Repository	Data platform	Role	Purpose
nexa-agents-api	Databricks	Control plane	Validate, materialize (to Git), promote, and track agents & automations. Served at /agentapi.
nexa-snowflake-agents-api	Snowflake	Control plane	Snowflake twin (Snowpark/Cortex).
nexa-databricks-agents	Databricks	Artifact repo	Where agent artifacts are materialized and deployed from.
nexa-snowflake-agents	Snowflake	Artifact repo	Snowflake agent artifacts.
nexa-workflow-automations	Databricks	Runtime	Automation engine + per-automation artifacts run as Databricks jobs (Asset Bundle).
nexa-snowflake-automations	Snowflake	Runtime	Automations as Snowflake Tasks backed by stored procedures.
actg-ai	Databricks (shared)	AI engine	Raw→Curated→TDM mapping, conflict detection/resolution, tagger/mapper. Served at /llm.

Ingestion, pipelines & intelligence

Data-movement and unstructured-data components (per data platform).

Repository	Data platform	Purpose
nexa-databricks-ingestion	Databricks	Source ingestion into the Raw layer.
snowflake-ingestion	Snowflake	Ingestion twin.
nexa-snowflake-pipelines	Snowflake	Generated Snowflake pipeline artifacts.
nexa-databricks-document-intelligence	Databricks	Document/RAG intelligence (indexes, jobs per RAG).
nexa-snowflake-unstructured-intelligence	Snowflake	Unstructured/document intelligence twin.

Chat & messaging services

Supporting runtime services deployed alongside the core stack (see GitOps for which have manifests).

Repository	Purpose
nexa-slackbot-service	Slack integration service (ECR-published, port 8000).
nexa-teamsbot-service	Microsoft Teams integration service.
nexa-stt-service	Speech-to-text service (path /stt).
nexa-slack-databricks-app / nexa-snowflake-slack-app	Data-platform-native Slack apps.
nexa-snowflake-teams-app	Snowflake-native Teams app.

Infrastructure as Code

Terraform/Terragrunt that provisions the substrate. Environments are separated by environments/{dev,test,prod}.tfvars, not Terraform workspaces.

Repository	Cloud / target	Provisions
aws-iac	AWS	VPC, EKS 1.34, RDS Postgres, ECR, IAM/Pod Identity, Route53, Secrets Manager, SSM Parameter Store.
nexa-azure-app-iac	Azure	VNet, AKS 1.34, Postgres Flexible Server, ACR, Key Vault, Workload Identity, Azure DNS — and the Azure Databricks workspace itself.
nexa-azure-databricks-iac	Azure Databricks	Workspace-level Unity Catalog governance (catalogs, warehouses, clusters, secret scopes).
drai-customer-databricks-iac	AWS Databricks	Full E2/MWS workspace build (SRA-based) — networks, S3+KMS, PrivateLink, metastore, VPC peering.
nexa-db-iac / nexa-databricks-db-iac / nexa-snowflake-db-iac	Postgres (Liquibase)	Application Postgres schema/table migrations.

Deployments & GitOps

How built images become running workloads.

Repository	Purpose
nexa-deployments	The GitOps source of truth: Kustomize base/overlays + ArgoCD app-of-apps for the AWS/EKS clusters.
nexa-aws-sf-deployments	Deployment repo for the AWS + Snowflake (SPCS) combination.
nexa-azure-app-deployments	Azure/AKS deployment manifests.
drai-customer-app-deployments	Customer-facing app deployment manifests (and its -template).
drai-customer-releases	Receives image-version-update release dispatches from the image CI.

Docs

Repository	Purpose
nexa-docs	This Astro Starlight documentation site (four audience topics; see the authoring guide).