Introduction¶

epymodelingsuite-cloud provides infrastructure to run epidemic modeling workflows at scale on Google Cloud, with a dedicated CLI tool (epycloud) that provides a developer-friendly interface. It runs epymodelingsuite, a Python package designed for simulating and calibrating epidemic models using YAML-defined experiment sets on the epydemix engine, which allows for routine forecasts.

Just One Command¶

Once set up, running epidemic forecasts is this simple:

epycloud run workflow --exp-id myexperiment

Built on epydemix¶

This project is built on epydemix, a Python package for epidemic modeling. See Ecosystem for how the components fit together.

Local and cloud support¶

The pipeline is designed to run both locally and on the cloud. All stages run inside Docker containers, so switching between local and cloud is transparent; just add --local option to run on your machine.

For more details, see Architecture: Execution Modes.

Learn More¶

To understand the system in depth:

Next Steps¶

Ready to start using epycloud?

• Installing epycloud: Install the epycloud CLI tool
• Quick Start: Run your first local workflow in 10 minutes
• Cloud Deployment: Deploy infrastructure to Google Cloud

For technical deep dive:

• Architecture Overview: Detailed system architecture