Note: All documentation in this repo is available as rendered/searchable HTML here.
The Modern Data Architecture Accelerator (MDAA) deploys secure, compliant modern Data and AI architectures on AWS in minutes. Pick a starter kit, fill in your environment details, and deploy — MDAA handles security compliance, encryption, and IAM best practices automatically.
Building a secure, compliant data and AI platform on AWS typically takes months of architecture design, security reviews, and infrastructure coding. MDAA compresses that into minutes. You get production-ready infrastructure that passes compliance audits on day one — not after weeks of remediation.

MDAA can be used to build an architecture to solve any variety of data or AI problem, including:

Additionally, MDAA can be used to build complex, multi-domain and multi-account data and AI architectures:

| Without MDAA | With MDAA |
|---|---|
![]() |
![]() |
Start by identifying the business problem you need to solve, then select the starter kit that provides the best coverage of required capabilities. Starter kits are just starting points — deploy as-is or modify and extend with additional modules and configurations to match your requirements. If necessary, MDAA deployments can be further customized through code-level escape hatches.

| Starter Kit | What you get | Est. Deploy Time |
|---|---|---|
| Minimal | IAM roles, Glue Catalog encryption, LakeFormation settings — build from scratch | ~5–10 min |
| GenAI Foundation | Enterprise-ready Bedrock Agent with RAG and knowledge bases | ~10–15 min |
| GenAI GAIA Chatbot | RAG chatbot backend with document search, auth, and streaming API | ~10–15 min |
| Basic DataLake | Encrypted S3 storage, data catalog, SQL queries, audit trail | ~15–20 min |
| Basic DataScience Platform | Notebook environment with shared data lake and team isolation | ~20–30 min |
| MLOps Platform | Automated train → deploy → monitor pipeline for ML models | ~20–30 min |
| DataZone Governed Lakehouse | Data lake with row/column-level security and a data product catalog | ~20–25 min |
| SMUS Research Environment | Self-service ML platform for multiple research teams | ~20–25 min |
| Health Data Accelerator | Automated pipeline from source databases to a curated data lake | ~30–45 min |
| SMUS Data Mesh | Multi-account data platform with cross-team data sharing | ~30–45 min |
Copy the contents of your chosen starter kit from starter_kits/<kit-name>/ into your own project directory. These are plain YAML files — no build tools or dependencies required.
cp -r starter_kits/basic_datalake ./my-project
cd ./my-project
Address the # TODO: comments in the config files (org name, account details, CDK Nag suppressions).
Each kit includes a Deployment section with prerequisites, configuration steps, and deploy commands. See the starter kit's README for details (README will also be in the created starter config directory).
For general deployment guidance, see PREDEPLOYMENT and DEPLOYMENT.
Once deployed, start using your new architecture (see the kit's USAGE.md) or enhance it with additional capabilities from the available modules.
MDAA includes 40+ modules for governance, data lakes, pipelines, analytics, AI, and utilities. Browse the full list with documentation at aws.github.io/modern-data-architecture-accelerator.

@aws-mdaa/gaia-v2; v1 remains published for existing deployments and will be removed in v1.9.0. See the migration guide.See SECURITY.md for details on MDAA's security design principles and compliance approach.
See CONTRIBUTING.md for information on reporting security issues.
Browse the full documentation, module references, and configuration schemas at aws.github.io/modern-data-architecture-accelerator.
MDAA can be used and extended in three ways:
Deploy compliant, end-to-end data and AI environments using YAML config files and the MDAA CLI. No code required - accessible to all roles, from simple to complex deployments with high compliance assurance.
Build custom data and AI environments using MDAA's reusable CDK constructs. Multi-language support (TypeScript, Python, Java, .NET) for L2 constructs; L3 constructs are currently TypeScript-only.
Independently developed workloads (CDK or CloudFormation) can leverage MDAA-deployed resources via the standard set of SSM (Systems Manager) parameters published by all MDAA modules.

This solution collects anonymous operational metrics to help AWS improve quality and features. For more information, including how to disable this capability, see the CDK version reporting documentation.
For detailed guides, see:
Full documentation and module reference is available at aws.github.io/modern-data-architecture-accelerator. To generate the docs locally, run mkdocs serve from the project root (requires MkDocs).
We welcome contributions from the community. See CONTRIBUTING.md for guidelines on how to get started, set up your development environment, and submit pull requests.
This project is licensed under the Apache-2.0 License.