Skip to content
Serverless batch computing made simple.
Branch: master
Clone or download
Pull request Compare This branch is 6 commits ahead, 3 commits behind faastjs:master.
0xflotus Merge pull request #3 from 0xflotus/patch-1
Update 12-contributing.md
Latest commit 3bf6cac May 4, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci ci: Add nightly cleanup to ci, ensures testing from empty account onc… May 3, 2019
.vscode
build Change google-save-key into regular js Apr 5, 2019
docs
etc prep for npm publish Apr 23, 2019
examples
measurements
src fix(aws): Fix issue with not creating default role. May 3, 2019
test-perf Remove the module path argument from faast, which is probably the big… Apr 16, 2019
test
types Upgrade api-extractor and api-documenter, and typescript dependencies. Apr 5, 2019
website
.gitignore Add test-release script to package a tarball and ensure it works. To … Apr 24, 2019
CODE_OF_CONDUCT.md
CONTRIBUTING.md Change GitHub org to `faastjs` Apr 4, 2019
LICENSE Fill in blanks in license file. Make sure package.json specifies Apac… Apr 4, 2019
README.md docs(blog): Draft blog post (faastjs#27) May 2, 2019
api-extractor.json prep for npm publish Apr 23, 2019
codecov.yml
index.ts Fix typo in API docs. Apr 23, 2019
package-lock.json chore(deps): update dependency nyc to v14.1.0 May 3, 2019
package.json Merge branches 'master' and 'master' of github.com:faastjs/faast.js May 3, 2019
tsconfig.json Add test-release script to package a tarball and ensure it works. To … Apr 24, 2019
tslint.json

README.md

faast.js

License CircleCI codecov Codacy Badgesemantic-release

Faast.js makes regular functions callable as serverless functions on AWS Lambda and Google Cloud. 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.

Installation

Faast.js requires node version 8+.

$ npm install faastjs

Example

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

// functions.ts
export function hello(name: string) {
    return "hello " + name;
}

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

// main.ts
import { faast } from "faastjs";
import * as funcs from "./functions";

(async () => {
    const m = await faast("aws", funcs);
    const { hello } = m.functions;
    const result = await hello("world!");
    console.log(result);
    await m.cleanup();
})();

Make 1000 concurrent calls if you like:

const promises: string[] = [];
for (let i = 0; i < 1000; i++) {
    promises.push(hello(`world ${i}!`));
}
await Promise.all(promises);

How much did that cost...?

const cost = await m.costSnapshot();
console.log(`$${cost.total()}`);

Relax. It's just half a penny:

$0.00420858

Features

  • 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 or GCP 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.
  • Multi-cloud: Built-in support for AWS Lambda and Google Cloud Functions, as well as local processing mode when you don't have network access. Switch with one line of code.

Ready to learn more?

Check out our getting started documentation.

Work through some examples

Review the detailed API documentation.

Join our slack channel. Already joined? sign in.

Follow us on twitter.

Contributing

See contributing.

You can’t perform that action at this time.