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

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.52.3.tar.gz (1.9 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fal-1.52.3-py3-none-any.whl (196.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: fal-1.52.3.tar.gz
  • Upload date:
  • Size: 1.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for fal-1.52.3.tar.gz
Algorithm Hash digest
SHA256 3a5bb41fab3a33c039aa51e4e9d090908ce5699b7f20ab6ff67b316348fe3376
MD5 3cca29c89f2f9f101814381c05e8e0a6
BLAKE2b-256 cbf918884d2d269bf56c20b3a4af3d531e3560473235384e07c69a531a76595e

See more details on using hashes here.

Provenance

The following attestation bundles were made for fal-1.52.3.tar.gz:

Publisher: release.yaml on fal-ai/fal

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

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

File metadata

  • Download URL: fal-1.52.3-py3-none-any.whl
  • Upload date:
  • Size: 196.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for fal-1.52.3-py3-none-any.whl
Algorithm Hash digest
SHA256 1e3d64f01a8cacb327d50f6f7c56f6bfc45a5981e3a84675f4164c25311887b5
MD5 f4899b0b0adddbd2e19f5a66bfa9ab3a
BLAKE2b-256 6eaf87172ccaac3320dd8d03d94fb2744f0e7518c769ddbf3c60a06736f0fe06

See more details on using hashes here.

Provenance

The following attestation bundles were made for fal-1.52.3-py3-none-any.whl:

Publisher: release.yaml on fal-ai/fal

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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