Quick Start

Welcome to Asyncy Beta 🎉 We are very excited to share our product and receive your feedback.

Get started

To get started, install our CLI:


brew install asyncy/brew/asyncy

Ubuntu 16+

sudo snap install asyncy --classic

Snap is available on other Linux OS.

Direct from Python

pip install --user asyncy

We strongly recommend using the other installation techniques.

Next, login using your GitHub account:

asyncy login

All done! You're all set to create and deploy apps written in Storyscript.

If you're having trouble logging in via GitHub, please reach out to us.

Write your first Story

Storyscript is a new programming language, but don't worry, it's built for developers taking favourite features of many languages. You'll see familiar syntax to Python, Ruby, Clojure and Node.

Let's create your first application, to be able to check out the samples which are bundled.

mkdir first_app && cd first_app
asyncy apps:create

Doing so will create asyncy.yml in the current directory. This file contains metadata about your new app.

We have created a few examples that can help you bootstrap your project:

asyncy bootstrap

Let's choose the HTTP endpoint:

asyncy bootstrap http > http.story && cat http.story
http server as client
    when client listen method: 'get' path: '/' as request
        request write content: 'Hello world!'

Let's deploy this story:

asyncy deploy
Deploying app competent-nash-82...
√ Done!
If your story listens to HTTP requests, visit https://competent-nash-82.asyncyapp.com

✨🍰✨ Congratulations! You have just deployed your first Asyncy application!

Note: asyncy deploy will deploy all the stories in your project at once.

See it live!

Check the deployment output. It will indicate where your story was deployed.

Learn more about Storyscript

Checkout our extensive documentation about Storyscript

Deploy changes

Ready to redeploy your application? We made it easy and intuitive.

Just run the same deploy command again:

asyncy deploy

✨🍰✨ Your application is now live!


Deploy a simple file upload and download story.