]> git.proxmox.com Git - ceph.git/blame - ceph/src/arrow/docs/source/python/install.rst
import quincy 17.2.0
[ceph.git] / ceph / src / arrow / docs / source / python / install.rst
CommitLineData
1d09f67e
TL
1.. Licensed to the Apache Software Foundation (ASF) under one
2.. or more contributor license agreements. See the NOTICE file
3.. distributed with this work for additional information
4.. regarding copyright ownership. The ASF licenses this file
5.. to you under the Apache License, Version 2.0 (the
6.. "License"); you may not use this file except in compliance
7.. with the License. You may obtain a copy of the License at
8
9.. http://www.apache.org/licenses/LICENSE-2.0
10
11.. Unless required by applicable law or agreed to in writing,
12.. software distributed under the License is distributed on an
13.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14.. KIND, either express or implied. See the License for the
15.. specific language governing permissions and limitations
16.. under the License.
17
18Installing PyArrow
19==================
20
21System Compatibility
22--------------------
23
24PyArrow is regularly built and tested on Windows, macOS and various Linux
25distributions (including Ubuntu 16.04, Ubuntu 18.04). We strongly recommend
26using a 64-bit system.
27
28Python Compatibility
29--------------------
30
31PyArrow is currently compatible with Python 3.6, 3.7, 3.8, and 3.9.
32
33Using Conda
34-----------
35
36Install the latest version of PyArrow from
37`conda-forge <https://conda-forge.org/>`_ using `Conda <https://conda.io>`_:
38
39.. code-block:: bash
40
41 conda install -c conda-forge pyarrow
42
43Using Pip
44---------
45
46Install the latest version from `PyPI <https://pypi.org/>`_ (Windows, Linux,
47and macOS):
48
49.. code-block:: bash
50
51 pip install pyarrow
52
53If you encounter any importing issues of the pip wheels on Windows, you may
54need to install the `Visual C++ Redistributable for Visual Studio 2015
55<https://www.microsoft.com/en-us/download/details.aspx?id=48145>`_.
56
57.. warning::
58 On Linux, you will need pip >= 19.0 to detect the prebuilt binary packages.
59
60Installing from source
61----------------------
62
63See :ref:`python-development`.
64
65Installing Nightly Packages
66---------------------------
67
68.. warning::
69 These packages are not official releases. Use them at your own risk.
70
71PyArrow has nightly wheels and conda packages for testing purposes.
72
73These may be suitable for downstream libraries in their continuous integration
74setup to maintain compatibility with the upcoming PyArrow features,
75deprecations and/or feature removals.
76
77Install the development version of PyArrow from `arrow-nightlies
78<https://anaconda.org/arrow-nightlies/pyarrow>`_ conda channel:
79
80.. code-block:: bash
81
82 conda install -c arrow-nightlies pyarrow
83
84Install the development version from an `alternative PyPI
85<https://gemfury.com/arrow-nightlies>`_ index:
86
87.. code-block:: bash
88
89 pip install --extra-index-url https://pypi.fury.io/arrow-nightlies/ \
90 --prefer-binary --pre pyarrow