<!-- Documentation index: https://mobs-lab.github.io/epymodelingsuite-cloud/llms.txt -->
<!-- Full documentation: https://mobs-lab.github.io/epymodelingsuite-cloud/llms-full.txt -->

# epymodelingsuite-cloud

Serverless, scalable pipeline for running epydemix simulations/calibrations on Google Cloud using Cloud Batch + Workflows.

[Get Started](https://mobs-lab.github.io/epymodelingsuite-cloud/overview/introduction.md){ .md-button .md-button--primary }
[View on GitHub](https://github.com/mobs-lab/epymodelingsuite-cloud){ .md-button }

---

## Features

<div class="grid cards" markdown>

-   :material-cloud:{ .lg .middle } **Cloud-Native**

    ---

    Built for Google Cloud Batch + Workflows with seamless Google Cloud integration

-   :material-rocket-launch:{ .lg .middle } **Scalable & Parallel**

    ---

    Scale simulations in parallel via Cloud Batch

-   :material-docker:{ .lg .middle } **Containerized**

    ---

    Docker-based pipeline for consistent, reproducible environments

-   :material-cog:{ .lg .middle } **Flexible Configuration**

    ---

    YAML-based configuration with environment and disease profiles

-   :material-swap-horizontal:{ .lg .middle } **Cloud & Local**

    ---

    Run the same pipeline locally with Docker Compose or on Google Cloud

-   :material-terraform:{ .lg .middle } **Infrastructure as Code**

    ---

    Terraform-managed Google Cloud resources for reproducible deployments

</div>

---

## Documentation

<div class="grid cards" markdown>

-   :material-information-outline:{ .lg .middle } **[Overview](https://mobs-lab.github.io/epymodelingsuite-cloud/overview/introduction.md)**

    ---

    Introduction, ecosystem, and the epycloud CLI

-   :material-rocket-launch:{ .lg .middle } **[Getting Started](https://mobs-lab.github.io/epymodelingsuite-cloud/getting-started/installation.md)**

    ---

    Installation, local execution, and cloud deployment

-   :material-sitemap:{ .lg .middle } **[Architecture](https://mobs-lab.github.io/epymodelingsuite-cloud/architecture/index.md)**

    ---

    Pipeline stages, execution modes, and cloud infrastructure

-   :material-book-open-variant:{ .lg .middle } **[User Guide](https://mobs-lab.github.io/epymodelingsuite-cloud/user-guide/index.md)**

    ---

    Configuration, building, running, monitoring, and troubleshooting

-   :material-terminal:{ .lg .middle } **[epycloud Reference](https://mobs-lab.github.io/epymodelingsuite-cloud/epycloud/index.md)**

    ---

    Complete CLI command reference for epycloud

-   :material-code-braces:{ .lg .middle } **[Development](https://mobs-lab.github.io/epymodelingsuite-cloud/development/index.md)**

    ---

    Contributing, development setup, and testing

</div>
