README.md

Awesome Kurtosis

A curated list of Kurtosis Packages written in Starlark.

These packages provide a starting point for understanding how to setup, test, and manage different types of environments using the Kurtosis CLI.

You can run any of these examples without installing anything in the Kurtosis Playground. Simply open the playground and run the following (swapping redis-voting-app with the subdirectory of the example you want):

kurtosis run github.com/kurtosis-tech/awesome-kurtosis/redis-voting-app

Contents

• Kurtosis Starlark Packages in the Web2 Space
• Kurtosis Starlark Packages in the Web3 Space
• Tests and other examples

Kurtosis Web2 Starlark Packages

• Auto-GPT Package - installs and starts AutoGPT locally with just 2 commands and with the memory backend of your choice. It's like AutoGPT got brew install. Built to simplify the install instructions of the popular open-source attempt to make GPT-4 fully autonomous: Auto-GPT by Significant Gravitas.
• Cassandra Package - spins up an n node Cassandra cluster and verifies that the cluster that was spun up was healthy
• Redis Package - spins up a Redis instance
• Etcd Package - spins up a Etcd instance - authored by @laurentluce
• RabbitMq Package - spins up a RabbitMQ instance - authored by @laurentluce
• Datastore Army Package - spins up an n node Datastore server cluster
• MongoDB - spins up a MongoDB database
• Postgres - spins up a local Postgres database
• Keycloak - spins up a local Keycloak server with a preconfigured application.
• Novu - spins up a full Novu environment

Kurtosis Web3 Starlark Packages

• Ethereum Package - spins up a local Proof-of-Stake (PoS) Ethereum testnet, supporting supporting 9 different EL and CL clients including geth, lighthouse, lodestar, nimbus and erigon.
• Avalanche Node Package - spins up a local, non-staking Avalanche Go node for local development and testing. This package can also be used to connect to other containerized services that make up your distributed system, like an instance of a wallet, indexer, explorer, or your dApp.
• Aptos Validator Node with Faucet - sets up a local Aptos validator node and a testnet faucet for use in local development and testing workflows on the Aptos protocol.
• Aptos Configurable Topology - sets up a local Aptos testnet with n validator, validator full nodes and public full nodes.
• NEAR Package - spins up a local NEAR testnet with a local RPC endpoint, a NEAR explorer, an indexer for the explorer, and a NEAR wallet.
• Chainlink Node Package - instantiates a local Chainlink node for development and prototyping against Decentralized Oracle Networks (DONs). Includes the ability to optionally connect to a local multi-client Ethereum testnet, based off of the Ethereum Foundation's Ethereum Package. Inspiration comes from the original Chainlink Node docs.

Tests and other examples

• Quick Start - The example used in the Quickstart guide to get started with Kurtosis.
• Simple NodeJS API - An example of how a Simple NodeJS based API can be setup to test using Kurtosis
• Data Package - An example package that contains a tar that you can import and use within the Quickstart and other packages
• Redis Voting App - An example package highlighting composition in Kurtosis that uses the redis-package and Azure Voting Front to spin up a voting app backed by Redis.
• Flink-Kafka Package - An example of integrating a Flink job with Kafka, composed using the Flink package