Repository files navigation

Faast.js makes regular functions callable as serverless functions on AWS Lambda. It handles the details of uploading your code, creating cloud infrastructure, and cleaning up. Scale up your functions to a thousand cores in seconds 🚀

Faast.js is a pure library with no service dependencies, operational overhead, or unnecessary complexity.

Faast.js requires node version 8+.

$ npm install faastjs

First write the functions you want to run in a serverless function. Make sure to export them:

// functions.tsexportfunctionhello(name:string){return"hello "+name;}

Use faast.js to turn this into a serverless function:

// main.tsimport{faast}from"faastjs";import*asfuncsfrom"./functions";(async()=>{constm=awaitfaast("aws",funcs);const{ hello}=m.functions;constresult=awaithello("world!");console.log(result);awaitm.cleanup();})();

Make 1000 concurrent calls if you like:

constpromises:string[]=[];for(leti=0;i<1000;i++){promises.push(hello(`world${i}!`));}awaitPromise.all(promises);

How much did that cost...?

constcost=awaitm.costSnapshot();console.log(`$${cost.total()}`);

Relax. It's just half a penny:

$0.00420858

• Frictionless. Faast.js takes care of packaging your code, setting up IAM roles, and other infrastructure complexity. Run your code on a thousand cores in seconds. All you need is an AWS account.
• Scalable. Use serverless functions to scale your batch jobs up to thousands of cores.
• Cost-effective. Understand and optimize your workload costs in real time. Pay only for compute time actually used.
• Ephemeral. No clusters or services to manage. Faast.js creates the infrastructure it uses on the fly and cleans up when it's done.
• Productive. First class support for TypeScript and JavaScript. Type safety, documentation, and extensive testing are part of our DNA.
• Local. Built-in support for AWS Lambda and local processing mode when you don't have network access. Switch with one line of code.

Check out ourgetting started documentation.

Work through someexamples

Review the detailedAPI documentation.

Join ourdiscord channel.

Follow us ontwitter.

Seecontributing.