Need help with chalice?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

8.3K Stars 850 Forks Apache License 2.0 2.2K Commits 328 Opened issues


Python Serverless Microframework for AWS

Services available


Need anything else?

Contributors list


AWS Chalice

.. image:: :target: :alt: Gitter .. image:: :target: :alt: Documentation Status

.. image:: :target: :alt: Chalice Logo

Chalice is a framework for writing serverless apps in python. It allows you to quickly create and deploy applications that use AWS Lambda. It provides:

  • A command line tool for creating, deploying, and managing your app
  • A decorator based API for integrating with Amazon API Gateway, Amazon S3, Amazon SNS, Amazon SQS, and other AWS services.
  • Automatic IAM policy generation

You can create Rest APIs:

.. code-block:: python

from chalice import Chalice

app = Chalice(app_name="helloworld")

@app.route("/") def index(): return {"hello": "world"}

Tasks that run on a periodic basis:

.. code-block:: python

from chalice import Chalice, Rate

app = Chalice(app_name="helloworld")

Automatically runs every 5 minutes

@app.schedule(Rate(5, unit=Rate.MINUTES)) def periodic_task(event): return {"hello": "world"}

You can connect a lambda function to an S3 event:

.. code-block:: python

from chalice import Chalice

app = Chalice(app_name="helloworld")

Whenever an object is uploaded to 'mybucket'

this lambda function will be invoked.

@app.on_s3_event(bucket='mybucket') def handler(event): print("Object uploaded for bucket: %s, key: %s" % (event.bucket, event.key))

As well as an SQS queue:

.. code-block:: python

from chalice import Chalice

app = Chalice(app_name="helloworld")

Invoke this lambda function whenever a message

is sent to the my-queue-name SQS queue.

@app.on_sqs_message(queue='my-queue-name') def handler(event): for record in event: print("Message body: %s" % record.body)

And several other AWS resources.

Once you've written your code, you just run

chalice deploy
and Chalice takes care of deploying your app.


$ chalice deploy

$ curl https://endpoint/api {"hello": "world"}

Up and running in less than 30 seconds. Give this project a try and share your feedback with us here on Github.

The documentation is available



.. quick-start-begin

In this tutorial, you'll use the

command line utility to create and deploy a basic REST API. This quickstart uses Python 3.7, but AWS Chalice supports all versions of python supported by AWS Lambda, which includes python2.7, python3.6, python3.7, python3.8. We recommend you use a version of Python 3. You can find the latest versions of python on the
Python download page 

To install Chalice, we'll first create and activate a virtual environment in python3.7::

$ python3 --version
Python 3.7.3
$ python3 -m venv venv37
$ . venv37/bin/activate

Next we'll install Chalice using

$ python3 -m pip install chalice

You can verify you have chalice installed by running::

$ chalice --help
Usage: chalice [OPTIONS] COMMAND [ARGS]...


Before you can deploy an application, be sure you have credentials configured. If you have previously configured your machine to run boto3 (the AWS SDK for Python) or the AWS CLI then you can skip this section.

If this is your first time configuring credentials for AWS you can follow these steps to quickly get started::

$ mkdir ~/.aws
$ cat >> ~/.aws/config
region=YOUR_REGION (such as us-west-2, us-west-1, etc)

If you want more information on all the supported methods for configuring credentials, see the

boto3 docs

Creating Your Project

The next thing we'll do is use the

command to create a new project::
$ chalice new-project helloworld

This will create a

directory. Cd into this directory. You'll see several files have been created for you::
$ cd helloworld
$ ls -la
drwxr-xr-x   .chalice
-rw-r--r--   requirements.txt

You can ignore the

directory for now, the two main files we'll focus on is

Let's take a look at the

.. code-block:: python

from chalice import Chalice

app = Chalice(app_name='helloworld')

@app.route('/') def index(): return {'hello': 'world'}


command created a sample app that defines a single view,
, that when called will return the JSON body
{"hello": "world"}


Let's deploy this app. Make sure you're in the

directory and run
chalice deploy
$ chalice deploy
Creating deployment package.
Creating IAM role: helloworld-dev
Creating lambda function: helloworld-dev
Creating Rest API
Resources deployed:
  - Lambda ARN: arn:aws:lambda:us-west-2:12345:function:helloworld-dev
  - Rest API URL:

You now have an API up and running using API Gateway and Lambda::

$ curl
{"hello": "world"}

Try making a change to the returned dictionary from the

function. You can then redeploy your changes by running
chalice deploy

.. quick-start-end

Next Steps

You've now created your first app using

. You can make modifications to your
file and rerun
chalice deploy
to redeploy your changes.

At this point, there are several next steps you can take.

  • Tutorials 
    • Choose from among several guided tutorials that will give you step-by-step examples of various features of Chalice.
  • Topics 
    __ - Deep dive into documentation on specific areas of Chalice. This contains more detailed documentation than the tutorials.
  • API Reference 
    __ - Low level reference documentation on all the classes and methods that are part of the public API of Chalice.

If you're done experimenting with Chalice and you'd like to cleanup, you can use the

chalice delete
command, and Chalice will delete all the resources it created when running the
chalice deploy


$ chalice delete
Deleting Rest API: abcd4kwyl4
Deleting function aws:arn:lambda:region:123456789:helloworld-dev
Deleting IAM Role helloworld-dev


We'd also love to hear from you. Please create any Github issues for additional features you'd like to see over at You can also chat with us on gitter:

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.