Skip to content
/ alto Public

Serverless for data practitioners. The fastest ⚡️ way to run your code in the cloud. Effortlessly run scripts, functions, and Jupyter notebooks in virtual machines.

License

Notifications You must be signed in to change notification settings

runprism/alto

Repository files navigation

Alto logo

Tests PyPI version Python version Checked with mypy Checked with flake8

Welcome to Alto!

Alto is the easiest way to run any code on the cloud! Alto is designed to be used with Prism projects, but it can be used to any arbitrary code (e.g., functions, scripts, Jupyter notebooks, or entire projects)!

Getting Started

Alto can be installed via pip. Alto requires Python >= 3.8.

pip install --upgrade pip
pip install alto-dev

Then, initialize a configuration file with the alto init CLI command. This command will automatically prompt you for all the information needed to configure your cloud environment.

$ alto init

What type of cloud environment do you want to use [ec2]? ec2
What would you like the name of your configuration file to be (default: alto.yml)?

<HH:MM:SS> | INFO | Building configuration file...
<HH:MM:SS> | INFO | Done!

To run your project on your cloud environment, use the alto build command. Under the hood, this command:

  1. Builds the cloud environment according to instructions contained in the configuration file, and
  2. Executes your project on the cloud.
$ alto build -f alto.yml
<HH:MM:SS> | INFO  | my_cloud_agent[build]  | Created key pair my_cloud_agent
<HH:MM:SS> | INFO  | my_cloud_agent[build]  | Created security group with ID sg-XXXXXXXXXXXXXXXXX in VPC vpc-XXXXXXXXXXXXXXXXX
<HH:MM:SS> | INFO  | my_cloud_agent[build]  | Created EC2 instance with ID i-XXXXXXXXXXXXXXXXX
<HH:MM:SS> | INFO  | my_cloud_agent[build]  | Instance i-XXXXXXXXXXXXXXXXX is pending... checking again in 5 seconds
<HH:MM:SS> | INFO  | my_cloud_agent[build]  | Instance i-XXXXXXXXXXXXXXXXX is pending... checking again in 5 seconds
<HH:MM:SS> | INFO  | my_cloud_agent[build]  | Instance i-XXXXXXXXXXXXXXXXX is pending... checking again in 5 seconds
<HH:MM:SS> | INFO  | my_cloud_agent[build]  | Instance i-XXXXXXXXXXXXXXXXX is pending... checking again in 5 seconds
...
...
<HH:MM:SS> | INFO  | my_cloud_agent[run]    | Done!
<HH:MM:SS> | INFO  | my_cloud_agent[delete] | Deleting key-pair my_cloud_agent at /../../../my_cloud_agent.pem
<HH:MM:SS> | INFO  | my_cloud_agent[delete] | Deleting instance i-XXXXXXXXXXXXXXXXX
<HH:MM:SS> | INFO  | my_cloud_agent[delete] | Deleting security group sg-XXXXXXXXXXXXXXXXX

Alternatively, you could use the alto apply command to first build the cloud environment and then use alto run to actually run the code.

Check out our documentation to see the full list of CLI command and their usage!

Cloud environments

Alto currently supports the following cloud environments (which we call "Agents"):

  • ec2

Product Roadmap

We're always looking to improve our product. Here's what we're working on at the moment:

  • Additional Agents: GCP Virtual Machines, EMR clusters, Databricks clusters, and more!
  • Managed service: Managed platform to easily view, manage, and schedule your different cloud deployments

Let us know if you'd like to see another feature!

About

Serverless for data practitioners. The fastest ⚡️ way to run your code in the cloud. Effortlessly run scripts, functions, and Jupyter notebooks in virtual machines.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages