| Name | fal JSON |
| Version |
1.26.6
JSON |
| download |
| home_page | None |
| Summary | fal is an easy-to-use Serverless Python Framework |
| upload_time | 2025-07-11 22:06:20 |
| maintainer | None |
| docs_url | None |
| author | Features & Labels <support@fal.ai> |
| requires_python | >=3.8 |
| license | None |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
[](https://pypi.org/project/fal)
[](https://github.com/fal-ai/fal/actions)
# 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:
```shell
pip install fal
```
Then you need to authenticate:
```shell
fal auth login
```
You can also use fal keys that you can get from [our dashboard](https://fal.ai/dashboard/keys).
Now can use the fal package in your Python scripts as follows:
```py
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](https://fal.ai/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
```py
pip install -e 'projects/fal[dev]'
pip install -e 'projects/fal_client[dev]'
pip install -e 'projects/isolate_proto[dev]'
```
### Running tests
```py
pytest
```
### Pre-commit
```bash
cd projects/fal
pre-commit install
```
### Commit format
Please follow [conventional commits specification](https://www.conventionalcommits.org/) for descriptions/messages.
Raw data
{
"_id": null,
"home_page": null,
"name": "fal",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Features & Labels <support@fal.ai>",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/c6/b8/b586b4ad62b207cddff4454c41304130b30cfe4b6220e2e449b76d182e40/fal-1.26.6.tar.gz",
"platform": null,
"description": "[](https://pypi.org/project/fal)\n[](https://github.com/fal-ai/fal/actions)\n\n# fal\n\nfal is a serverless Python runtime that lets you run and scale code in the cloud with no infra management.\n\nWith 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.\n\n## Quickstart\n\nFirst, you need to install the `fal` package. You can do so using pip:\n\n```shell\npip install fal\n```\n\nThen you need to authenticate:\n\n```shell\nfal auth login\n```\n\nYou can also use fal keys that you can get from [our dashboard](https://fal.ai/dashboard/keys).\n\nNow can use the fal package in your Python scripts as follows:\n\n```py\nimport fal\n\n@fal.function(\n \"virtualenv\",\n requirements=[\"pyjokes\"],\n)\ndef tell_joke() -> str:\n import pyjokes\n\n joke = pyjokes.get_joke()\n return joke\n\nprint(\"Joke from the clouds: \", tell_joke())\n```\n\nA 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.\n\n## Next steps\n\nIf you would like to find out more about the capabilities of fal, check out to the [docs](https://fal.ai/docs). You can learn more about persistent storage, function caches and deploying your functions as API endpoints.\n\n## Contributing\n\n### Installing in editable mode with dev dependencies\n\n```py\npip install -e 'projects/fal[dev]'\npip install -e 'projects/fal_client[dev]'\npip install -e 'projects/isolate_proto[dev]'\n```\n\n### Running tests\n\n```py\npytest\n```\n\n### Pre-commit\n\n```bash\ncd projects/fal\npre-commit install\n```\n\n### Commit format\n\nPlease follow [conventional commits specification](https://www.conventionalcommits.org/) for descriptions/messages.\n",
"bugtrack_url": null,
"license": null,
"summary": "fal is an easy-to-use Serverless Python Framework",
"version": "1.26.6",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "28494c912a7f8132cb9e48c7f33f0cdc1a80e7d011f0332b79270709f3d47079",
"md5": "34932223c510018af409766b2bf80834",
"sha256": "dc4e1209b26ef7c53c5af56d01ebb9feffb8c05e7912f97ae2c9d2bdec8e2379"
},
"downloads": -1,
"filename": "fal-1.26.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "34932223c510018af409766b2bf80834",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 165737,
"upload_time": "2025-07-11T22:06:18",
"upload_time_iso_8601": "2025-07-11T22:06:18.536880Z",
"url": "https://files.pythonhosted.org/packages/28/49/4c912a7f8132cb9e48c7f33f0cdc1a80e7d011f0332b79270709f3d47079/fal-1.26.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c6b8b586b4ad62b207cddff4454c41304130b30cfe4b6220e2e449b76d182e40",
"md5": "fe6fc619663f2d7192aecc18a2b585e8",
"sha256": "db8d961ac35e72433c628db7251dbe5f01dab02adf717631036e0c517d08fece"
},
"downloads": -1,
"filename": "fal-1.26.6.tar.gz",
"has_sig": false,
"md5_digest": "fe6fc619663f2d7192aecc18a2b585e8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 1825903,
"upload_time": "2025-07-11T22:06:20",
"upload_time_iso_8601": "2025-07-11T22:06:20.881677Z",
"url": "https://files.pythonhosted.org/packages/c6/b8/b586b4ad62b207cddff4454c41304130b30cfe4b6220e2e449b76d182e40/fal-1.26.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-11 22:06:20",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "fal"
}
