{
  "__type": "IngestedDoc",
  "__tag": 4010,
  "_content": {},
  "_ordered_sections": [],
  "item_file": null,
  "item_line": null,
  "item_type": null,
  "aliases": [],
  "example_section_data": {
    "__type": "Section",
    "__tag": 4015,
    "children": [],
    "title": [],
    "level": 0,
    "target": null
  },
  "see_also": [],
  "signature": null,
  "references": null,
  "qa": "install:install",
  "arbitrary": [
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "IPython requires Python ≥ 3.11."
            }
          ]
        }
      ],
      "title": [
        {
          "__type": "Text",
          "__tag": 4046,
          "value": "Installing IPython"
        }
      ],
      "level": 0,
      "target": "install"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "With "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "pip"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " already installed :"
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "$ pip install ipython",
          "execution_status": null
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "This installs IPython as well as its dependencies."
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "If you want to use IPython with notebooks or the Qt console, you should also install Jupyter "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "pip install jupyter"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "."
            }
          ]
        }
      ],
      "title": [
        {
          "__type": "Text",
          "__tag": 4046,
          "value": "Quick Install"
        }
      ],
      "level": 1,
      "target": null
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "This document describes in detail the steps required to install IPython. For a few quick ways to get started with package managers or full Python distributions, see "
            },
            {
              "__type": "Link",
              "__tag": 4049,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "the install page"
                }
              ],
              "url": "https://ipython.org/install.html",
              "title": ""
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " of the IPython website."
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Please let us know if you have problems installing IPython or any of its dependencies."
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "IPython and most dependencies should be installed via "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "pip"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": ". In many scenarios, this is the simplest method of installing Python packages. More information about "
            },
            {
              "__type": "CrossRef",
              "__tag": 4002,
              "value": "pip",
              "reference": {
                "__type": "RefInfo",
                "__tag": 4000,
                "module": "pip",
                "version": "*",
                "kind": "api",
                "path": "pip"
              },
              "kind": "module"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " can be found on "
            },
            {
              "__type": "Link",
              "__tag": 4049,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "its PyPI page"
                }
              ],
              "url": "https://pip.pypa.io",
              "title": ""
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "."
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "More general information about installing Python packages can be found in "
            },
            {
              "__type": "CrossRef",
              "__tag": 4002,
              "value": "Python's documentation",
              "reference": {
                "__type": "LocalRef",
                "__tag": 4022,
                "kind": "docs",
                "path": "installing/index"
              },
              "kind": "docs"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "."
            }
          ]
        }
      ],
      "title": [
        {
          "__type": "Text",
          "__tag": 4046,
          "value": "Overview"
        }
      ],
      "level": 1,
      "target": null
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "IPython relies on a number of other Python packages. Installing using a package manager like pip or conda will ensure the necessary packages are installed. Manual installation without dependencies is possible, but not recommended. The dependencies can be viewed with package manager commands, such as "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "pip show ipython"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " or "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "conda info ipython"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "."
            }
          ]
        }
      ],
      "title": [
        {
          "__type": "Text",
          "__tag": 4046,
          "value": "Dependencies"
        }
      ],
      "level": 2,
      "target": "dependencies"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "IPython requires several dependencies to work correctly, it is not recommended to install IPython and all its dependencies manually as this can be quite long and troublesome. You should use the python package manager "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "pip"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "."
            }
          ]
        }
      ],
      "title": [
        {
          "__type": "Text",
          "__tag": 4046,
          "value": "Installing IPython itself"
        }
      ],
      "level": 2,
      "target": null
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Make sure you have the latest version of "
            },
            {
              "__type": "CrossRef",
              "__tag": 4002,
              "value": "pip",
              "reference": {
                "__type": "RefInfo",
                "__tag": 4000,
                "module": "pip",
                "version": "*",
                "kind": "api",
                "path": "pip"
              },
              "kind": "module"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " (the Python package manager) installed. If you do not, head to "
            },
            {
              "__type": "Link",
              "__tag": 4049,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Pip documentation"
                }
              ],
              "url": "https://pip.pypa.io/en/stable/installing/",
              "title": ""
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " and install "
            },
            {
              "__type": "CrossRef",
              "__tag": 4002,
              "value": "pip",
              "reference": {
                "__type": "RefInfo",
                "__tag": 4000,
                "module": "pip",
                "version": "*",
                "kind": "api",
                "path": "pip"
              },
              "kind": "module"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " first."
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "The quickest way to get up and running with IPython is to install it with pip:"
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "$ pip install ipython",
          "execution_status": null
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "That's it."
            }
          ]
        }
      ],
      "title": [
        {
          "__type": "Text",
          "__tag": 4046,
          "value": "Installation using pip"
        }
      ],
      "level": 2,
      "target": null
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "IPython supports command-line completion via the "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "argcomplete"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " package. To enable tab completion for IPython and other Python programs that support argcomplete, install IPython with the "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "terminal"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " extra:"
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "$ pip install ipython[all]\n$ activate-global-python-argcomplete",
          "execution_status": null
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Alternatively, you can install argcomplete separately:"
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "$ pip install argcomplete\n$ activate-global-python-argcomplete",
          "execution_status": null
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "This will enable shell completion for all Python programs that support argcomplete, including IPython. Note that you may need to restart your shell for the changes to take effect."
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "For more information, see the "
            },
            {
              "__type": "Link",
              "__tag": 4049,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "argcomplete documentation"
                }
              ],
              "url": "https://github.com/kislyuk/argcomplete",
              "title": ""
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "."
            }
          ]
        }
      ],
      "title": [
        {
          "__type": "Text",
          "__tag": 4046,
          "value": "Optional: Command-line completion"
        }
      ],
      "level": 2,
      "target": null
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "It is also possible to install the development version of IPython from our "
            },
            {
              "__type": "Link",
              "__tag": 4049,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Git"
                }
              ],
              "url": "https://git-scm.com/",
              "title": ""
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " source code repository.  To do this you will need to have Git installed on your system."
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Then do:"
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "$ git clone https://github.com/ipython/ipython.git\n$ cd ipython\n$ pip install -e '.[test]'",
          "execution_status": null
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "The "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "pip install -e ."
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " command allows users and developers to follow the development branch as it changes by creating links in the right places and installing the command line scripts to the appropriate locations."
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Then, if you want to update your IPython at any time, do:"
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "$ git pull",
          "execution_status": null
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "If the dependencies or entrypoints have changed, you may have to run"
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "$ pip install -e .",
          "execution_status": null
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "again, but this is infrequent."
            }
          ]
        }
      ],
      "title": [
        {
          "__type": "Text",
          "__tag": 4046,
          "value": "Installing the development version"
        }
      ],
      "level": 2,
      "target": "devinstall"
    }
  ],
  "local_refs": []
}