Skip to main content

fal is an easy-to-use Serverless Python Framework

Project description

PyPI Tests

fal

fal is a serverless Python runtime that lets you run and scale code in the cloud with no infra management.

With fal, you can build pipelines, serve ML models and scale them up to many users. You scale down to 0 when you don't use any resources.

Quickstart

First, you need to install the fal package. You can do so using pip:

pip install fal

Then you need to authenticate:

fal auth login

You can also use fal keys that you can get from our dashboard.

Now can use the fal package in your Python scripts as follows:

import fal

@fal.function(
    "virtualenv",
    requirements=["pyjokes"],
)
def tell_joke() -> str:
    import pyjokes

    joke = pyjokes.get_joke()
    return joke

print("Joke from the clouds: ", tell_joke())

A new virtual environment will be created by fal in the cloud and the set of requirements that we passed will be installed as soon as this function is called. From that point on, our code will be executed as if it were running locally, and the joke prepared by the pyjokes library will be returned.

Next steps

If you would like to find out more about the capabilities of fal, check out to the docs. You can learn more about persistent storage, function caches and deploying your functions as API endpoints.

Contributing

Installing in editable mode with dev dependencies

pip install -e 'projects/fal[dev]'
pip install -e 'projects/fal_client[dev]'
pip install -e 'projects/isolate_proto[dev]'

Running tests

pytest

Pre-commit

cd projects/fal
pre-commit install

Commit format

Please follow conventional commits specification for descriptions/messages.

Project details


Release history Release notifications | RSS feed

This version

1.0.7

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fal-1.0.7.tar.gz (80.7 kB view details)

Uploaded Source

Built Distribution

fal-1.0.7-py3-none-any.whl (100.9 kB view details)

Uploaded Python 3

File details

Details for the file fal-1.0.7.tar.gz.

File metadata

  • Download URL: fal-1.0.7.tar.gz
  • Upload date:
  • Size: 80.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.0.0 CPython/3.12.4

File hashes

Hashes for fal-1.0.7.tar.gz
Algorithm Hash digest
SHA256 2980658dff460181b75a919a1d6281a759d97ede8e6c0268de309593f35499aa
MD5 72b71d2bfccb572dbe38d141c43f1f98
BLAKE2b-256 8f86c5d224ecc2dd82abe3a50839e8a824b9990da4081a4f4db8b9fa334b9f19

See more details on using hashes here.

File details

Details for the file fal-1.0.7-py3-none-any.whl.

File metadata

  • Download URL: fal-1.0.7-py3-none-any.whl
  • Upload date:
  • Size: 100.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.0.0 CPython/3.12.4

File hashes

Hashes for fal-1.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 852de6ea9c7908430c691a46ea6aed9aee2ad1b63c11daa6ca5a6fd3c8a069b9
MD5 1cfb976195b01cb9174f88da14aa321b
BLAKE2b-256 62c9e9fcffaec1d248f587a21466654786f94077ded2870d42131e4f135f823c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page