:html_theme.sidebar_secondary.remove:

.. _first_steps:

First steps
###########

.. toctree::
    :maxdepth: 2
    :hidden:
    :glob:

    first_steps/installation
    first_steps/*

.. _first_steps_installing:

Installing Bokeh
----------------

Bokeh is officially supported and tested on Python :bokeh-minpy:`cpython` and
above (CPython).

You can install Bokeh with either ``conda`` or ``pip``:

.. grid:: 1 1 2 2

    .. grid-item-card::

        Installing with ``pip``
        ^^^
        Use this command to install Bokeh:

        .. code-block:: sh

            pip install bokeh

    .. grid-item-card::

        Installing with ``conda``
        ^^^
        Use this command to install Bokeh:

        .. code-block:: sh

            conda install bokeh

        Conda requires either `Anaconda`_ or `Miniconda`_ to be installed on your
        system.

For more detailed information on installing and potential problems you might
encounter, go to the :ref:`installation` section.

.. _`first_steps_overview`:

First steps guides
------------------

Follow these guides to quickly learn about the most important features and
capabilities of Bokeh.

The first steps guides are for anybody who is new to Bokeh. The only
prerequisites for using these guides are a basic understanding of Python and a
working :ref:`installation<first_steps_installing>` of Bokeh.

The first steps guides include lots of examples that you can copy to your
development environment. There are also many links to the more in-depth
resources of the |user guide| and |reference guide| in case you want to learn
more about any of the topics covered in the first steps guides.

.. grid:: 1 2 2 3

    .. grid-item-card::

        Creating a simple line chart plot
        ^^^
        .. image:: /_images/first_steps_1.png
            :align: center
            :alt: A line chart
        +++
        .. button-link:: first_steps/first_steps_1.html

            Go to section 1

    .. grid-item-card::

        Adding and customizing renderers
        ^^^
        .. image:: /_images/first_steps_2.png
            :align: center
            :alt: Several glyphs in one chart
        +++
        .. button-link:: first_steps/first_steps_2.html

            Go to section 2

    .. grid-item-card::

        Adding legends, text, and annotations
        ^^^
        .. image:: /_images/first_steps_3.png
            :align: center
            :alt: A chart with a legend
        +++
        .. button-link:: first_steps/first_steps_3.html

            Go to section 3

    .. grid-item-card::

        Customizing your plot
        ^^^
        .. image:: /_images/first_steps_4.png
            :align: center
            :alt: A chart with a tootip
        +++
        .. button-link:: first_steps/first_steps_4.html

            Go to section 4

    .. grid-item-card::

        Vectorizing glyph properties
        ^^^
        .. image:: /_images/first_steps_5.png
            :align: center
            :alt: A chart with different colors
        +++
        .. button-link:: first_steps/first_steps_5.html

            Go to section 5

    .. grid-item-card::

        Combining plots
        ^^^
        .. image:: /_images/first_steps_6.png
            :align: center
            :alt: Three charts combined into one element
        +++
        .. button-link:: first_steps/first_steps_6.html

            Go to section 6

    .. grid-item-card::

        Displaying and exporting
        ^^^
        .. image:: /_images/first_steps_7.png
            :align: center
            :alt: Screenshot of a Bokeh plot in a Jupyter notebook
        +++
        .. button-link:: first_steps/first_steps_7.html

            Go to section 7

    .. grid-item-card::

        Providing and filtering data
        ^^^
        .. image:: /_images/first_steps_8.png
            :align: center
            :alt: Two charts with different subsets of data
        +++
        .. button-link:: first_steps/first_steps_8.html

            Go to section 8

    .. grid-item-card::

        Using widgets
        ^^^
        .. image:: /_images/first_steps_9.png
            :align: center
            :alt: Screenshot of a Bokeh server app
        +++
        .. button-link:: first_steps/first_steps_9.html

            Go to section 9

.. _Anaconda: https://www.anaconda.com/products/individual#Downloads
.. _Miniconda: https://docs.conda.io/en/latest/miniconda.html
