shiny


Nameshiny JSON
Version 1.5.0 PyPI version JSON
download
home_pageNone
SummaryA web development framework for Python.
upload_time2025-09-11 22:26:56
maintainerNone
docs_urlNone
authorNone
requires_python>=3.9
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Shiny for Python

[![PyPI Latest Release](https://img.shields.io/pypi/v/shiny.svg)](https://pypi.org/project/shiny/)
[![Build status](https://img.shields.io/github/actions/workflow/status/posit-dev/py-shiny/pytest.yaml?branch=main)](https://img.shields.io/github/actions/workflow/status/posit-dev/py-shiny/pytest.yaml?branch=main)
[![Conda Latest Release](https://anaconda.org/conda-forge/shiny/badges/version.svg)](https://anaconda.org/conda-forge/shiny)
[![Supported Python versions](https://img.shields.io/pypi/pyversions/shiny)](https://pypi.org/project/shiny/)
[![License](https://img.shields.io/github/license/posit-dev/py-shiny)](https://github.com/posit-dev/py-shiny/blob/main/LICENSE)

Shiny for Python is the best way to build fast, beautiful web applications in Python. You can build quickly with Shiny and create simple interactive visualizations and prototype applications in an afternoon. But unlike other frameworks targeted at data scientists, Shiny does not limit your app's growth. Shiny remains extensible enough to power large, mission-critical applications.

To learn more about Shiny see the [Shiny for Python website](https://shiny.posit.co/py/). If you're new to the framework we recommend these resources:

- How [Shiny is different](https://posit.co/blog/why-shiny-for-python/) from Dash and Streamlit.

- How [reactive programming](https://shiny.posit.co/py/docs/reactive-programming.html) can help you build better applications.

- How to [use modules](https://shiny.posit.co/py/docs/workflow-modules.html) to efficiently develop large applications.

- Hosting applications for free on [Connect Cloud](https://docs.posit.co/connect-cloud/how-to/python/shiny-python.html), [shinyapps.io](https://shiny.posit.co/py/docs/deploy.html#deploy-to-shinyapps.io-cloud-hosting), [Hugging Face](https://shiny.posit.co/blog/posts/shiny-on-hugging-face/), or [Shinylive](https://shiny.posit.co/py/docs/shinylive.html).

## Join the conversation

If you have questions about Shiny for Python, or want to help us decide what to work on next, [join us on Discord](https://discord.gg/yMGCamUMnS).

## Getting started

To get started with shiny follow the [installation instructions](https://shiny.posit.co/py/docs/install-create-run.html) or just install it from pip.

```sh
pip install shiny
```

To install the latest development version:

```sh
# First install htmltools, then shiny
pip install git+https://github.com/posit-dev/py-htmltools.git#egg=htmltools
pip install git+https://github.com/posit-dev/py-shiny.git#egg=shiny
```

You can create and run your first application with `shiny create`, the CLI will ask you which template you would like to use. You can either run the app with the Shiny extension, or call `shiny run app.py --reload --launch-browser`.

## Development

* Shinylive built from the `main` branch: https://posit-dev.github.io/py-shiny/shinylive/py/examples/
* API documentation for the `main` branch:
    * https://posit-dev.github.io/py-shiny/docs/api/express/
    * https://posit-dev.github.io/py-shiny/docs/api/core/

If you are working from a fork you may not have the git tags from the original repo.
Git tags are required for the install to succeed. To add tags to your own fork:

```sh
git remote add upstream https://github.com/posit-dev/py-shiny.git
git fetch --tags upstream
```

Then install:

```sh
pip install -e ".[dev,test,doc]"
```

Additionally, you can install pre-commit hooks which will automatically reformat and lint the code when you make a commit:

```sh
pre-commit install

# To disable:
# pre-commit uninstall
```

Tests should now pass:

```sh
make check
# To apply formatting fixes instead of erroring:
# make check-fix
```

Or get a full list of helpers with just:

```sh
make
```

Typically, when developing new features for Shiny, you'll want to try them out in an application.
In a **separate** application directory, use can use `-e` to reference your local checkout of `py-shiny`:

```sh
# Rather than
#   pip install shiny
# run:
pip install -e ../py-shiny --config-settings editable_mode=compat
```

See the [docs README](docs/README.md) for instructions on building the documentation locally.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "shiny",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": null,
    "author": null,
    "author_email": "Winston Chang <winston@posit.co>",
    "download_url": "https://files.pythonhosted.org/packages/09/00/588d12aaeb1179bcbb20d5841a6db722d1c01c922858bbbb49de58ea03c7/shiny-1.5.0.tar.gz",
    "platform": null,
    "description": "# Shiny for Python\n\n[![PyPI Latest Release](https://img.shields.io/pypi/v/shiny.svg)](https://pypi.org/project/shiny/)\n[![Build status](https://img.shields.io/github/actions/workflow/status/posit-dev/py-shiny/pytest.yaml?branch=main)](https://img.shields.io/github/actions/workflow/status/posit-dev/py-shiny/pytest.yaml?branch=main)\n[![Conda Latest Release](https://anaconda.org/conda-forge/shiny/badges/version.svg)](https://anaconda.org/conda-forge/shiny)\n[![Supported Python versions](https://img.shields.io/pypi/pyversions/shiny)](https://pypi.org/project/shiny/)\n[![License](https://img.shields.io/github/license/posit-dev/py-shiny)](https://github.com/posit-dev/py-shiny/blob/main/LICENSE)\n\nShiny for Python is the best way to build fast, beautiful web applications in Python. You can build quickly with Shiny and create simple interactive visualizations and prototype applications in an afternoon. But unlike other frameworks targeted at data scientists, Shiny does not limit your app's growth. Shiny remains extensible enough to power large, mission-critical applications.\n\nTo learn more about Shiny see the [Shiny for Python website](https://shiny.posit.co/py/). If you're new to the framework we recommend these resources:\n\n- How [Shiny is different](https://posit.co/blog/why-shiny-for-python/) from Dash and Streamlit.\n\n- How [reactive programming](https://shiny.posit.co/py/docs/reactive-programming.html) can help you build better applications.\n\n- How to [use modules](https://shiny.posit.co/py/docs/workflow-modules.html) to efficiently develop large applications.\n\n- Hosting applications for free on [Connect Cloud](https://docs.posit.co/connect-cloud/how-to/python/shiny-python.html), [shinyapps.io](https://shiny.posit.co/py/docs/deploy.html#deploy-to-shinyapps.io-cloud-hosting), [Hugging Face](https://shiny.posit.co/blog/posts/shiny-on-hugging-face/), or [Shinylive](https://shiny.posit.co/py/docs/shinylive.html).\n\n## Join the conversation\n\nIf you have questions about Shiny for Python, or want to help us decide what to work on next, [join us on Discord](https://discord.gg/yMGCamUMnS).\n\n## Getting started\n\nTo get started with shiny follow the [installation instructions](https://shiny.posit.co/py/docs/install-create-run.html) or just install it from pip.\n\n```sh\npip install shiny\n```\n\nTo install the latest development version:\n\n```sh\n# First install htmltools, then shiny\npip install git+https://github.com/posit-dev/py-htmltools.git#egg=htmltools\npip install git+https://github.com/posit-dev/py-shiny.git#egg=shiny\n```\n\nYou can create and run your first application with `shiny create`, the CLI will ask you which template you would like to use. You can either run the app with the Shiny extension, or call `shiny run app.py --reload --launch-browser`.\n\n## Development\n\n* Shinylive built from the `main` branch: https://posit-dev.github.io/py-shiny/shinylive/py/examples/\n* API documentation for the `main` branch:\n    * https://posit-dev.github.io/py-shiny/docs/api/express/\n    * https://posit-dev.github.io/py-shiny/docs/api/core/\n\nIf you are working from a fork you may not have the git tags from the original repo.\nGit tags are required for the install to succeed. To add tags to your own fork:\n\n```sh\ngit remote add upstream https://github.com/posit-dev/py-shiny.git\ngit fetch --tags upstream\n```\n\nThen install:\n\n```sh\npip install -e \".[dev,test,doc]\"\n```\n\nAdditionally, you can install pre-commit hooks which will automatically reformat and lint the code when you make a commit:\n\n```sh\npre-commit install\n\n# To disable:\n# pre-commit uninstall\n```\n\nTests should now pass:\n\n```sh\nmake check\n# To apply formatting fixes instead of erroring:\n# make check-fix\n```\n\nOr get a full list of helpers with just:\n\n```sh\nmake\n```\n\nTypically, when developing new features for Shiny, you'll want to try them out in an application.\nIn a **separate** application directory, use can use `-e` to reference your local checkout of `py-shiny`:\n\n```sh\n# Rather than\n#   pip install shiny\n# run:\npip install -e ../py-shiny --config-settings editable_mode=compat\n```\n\nSee the [docs README](docs/README.md) for instructions on building the documentation locally.\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A web development framework for Python.",
    "version": "1.5.0",
    "project_urls": {
        "Bug Tracker": "https://github.com/posit-dev/py-shiny/issues",
        "Documentation": "https://shiny.posit.co/py/",
        "Homepage": "https://github.com/posit-dev/py-shiny",
        "Repository": "https://github.com/posit-dev/py-shiny"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "ddac1d0da6abb068ce31207bd597c9b8a6bd623aa561142cc67eeea5160518d8",
                "md5": "7aaf9672fe43ec229d1efd2612f9a92d",
                "sha256": "97349fddd2212abaf588548f023b07944e4095fee5bc2c103ff53308ac472806"
            },
            "downloads": -1,
            "filename": "shiny-1.5.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "7aaf9672fe43ec229d1efd2612f9a92d",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 3924490,
            "upload_time": "2025-09-11T22:26:54",
            "upload_time_iso_8601": "2025-09-11T22:26:54.506316Z",
            "url": "https://files.pythonhosted.org/packages/dd/ac/1d0da6abb068ce31207bd597c9b8a6bd623aa561142cc67eeea5160518d8/shiny-1.5.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "0900588d12aaeb1179bcbb20d5841a6db722d1c01c922858bbbb49de58ea03c7",
                "md5": "c83c70bfafae8052a01351e89fdcd000",
                "sha256": "6a07b5057db4471a804b5f915def5db9eeec5ce0cc45d58ee2e174324c5471e0"
            },
            "downloads": -1,
            "filename": "shiny-1.5.0.tar.gz",
            "has_sig": false,
            "md5_digest": "c83c70bfafae8052a01351e89fdcd000",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 4905968,
            "upload_time": "2025-09-11T22:26:56",
            "upload_time_iso_8601": "2025-09-11T22:26:56.495990Z",
            "url": "https://files.pythonhosted.org/packages/09/00/588d12aaeb1179bcbb20d5841a6db722d1c01c922858bbbb49de58ea03c7/shiny-1.5.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-09-11 22:26:56",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "posit-dev",
    "github_project": "py-shiny",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "shiny"
}
        
Elapsed time: 0.83551s