Skip to main content

InGraph is an Infrastructure Graph DSL for AWS CloudFormation.

Project description


InGraph · Version License

InGraph ain't template generator :stuck_out_tongue_winking_eye:

InGraph is a Declarative Infrastructure Graph DSL for AWS CloudFormation.

  • Declarative: Never again abstract away from CloudFormation. Simply declare your infrastructure components, without the hassle of YAML, and preserve the strict semantic of the AWS CloudFormation language. Veterans, build on top of your knowledge. Beginners, learn CloudFormation effectively.

  • Composable: Create encapsulated components with their assets and dependencies, then share or compose them to build more complex infrastructures. From simple nodes to your whole graph, everything is a deployable infrastructure unit.

  • Integrated: Leverage the evergrowing Python ecosystem. Benefit from static type checking, take advantage of autocompletion in your editor, or even consume open infrastructure components via the Python Package Index, among others.

Learn how to use InGraph in your own project.


InGraph requires Python 3.8 or newer. Feel free to use your favorite tool or pip to install the ingraph package.

python3.8 -m pip install --user ingraph

Verify your installation by invoking the ig command. You should see a welcome screen.


We have several examples on the website. Here is the first one to whet your appetite.

ig cfn -i -r HelloWorld -o example.yaml

InGraph Example

This example creates a simple AWS Lambda function that returns a "Hello, World!" message.

You'll notice that CloudFormation parameters, along with their types and default values are simple constructor parameters, or that CloudFormation outputs are class attributes, or even that CloudFormation resource names are derived from variable names. It's only a taste of what is in store for you.


The primary purpose of this project is to continue to evolve the core of InGraph. We are grateful to the community for any contribution. You may, for example, proof-read the documentation, submit bugs and fixes, provide improvements, discuss new axes of evolution, or spread the word around you.


We want to thank and express our gratitude to Ben Kehoe. Without his guidance and support, this project wouldn't have been possible.


Unless otherwise stated, the source code of the project is released under the GNU Affero General Public License Version 3. Please note, however, that all public interfaces subject to be embedded within the source code of your infrastructure are released under the Apache License Version 2. Refer to the header of each file or to the LICENSE file present in the parent directory where appropriate.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ingraph-0.2.1.tar.gz (33.0 kB view hashes)

Uploaded source

Built Distribution

ingraph-0.2.1-py3-none-any.whl (36.9 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page