Skip to main content

How to Install yfinance for Yahoo Finance Data in Python

The yfinance library is a popular open-source tool for Python that provides a convenient way to download historical market data and other financial information from Yahoo Finance. To utilize yfinance in your financial analysis or data science projects, you must first install it into your Python environment. If you attempt to import yfinance before installation, or if it's installed in an incorrect environment, you'll encounter the ModuleNotFoundError: No module named 'yfinance'.

This guide provides step-by-step instructions for installing yfinance using pip and conda across various platforms and IDEs, and troubleshooting the ModuleNotFoundError.

What is yfinance?​

yfinance offers a threaded and Pythonic way to download historical market data from Yahoo Finance®. It allows users to fetch data for stock tickers, including historical prices, dividends, splits, company information, financials, options chains, and more. It's widely used by individual investors, traders, and financial analysts for data collection and analysis.

Solving ModuleNotFoundError: No module named 'yfinance'​

This error means Python's import system cannot find the yfinance package in its current search paths.

Cause: Package Not Installed or Incorrect Environment​

The most common reasons are:

  • You haven't installed the yfinance Python package yet.
  • You installed yfinance in a different Python environment (e.g., global Python) than the one your current script or IDE is using (e.g., a virtual environment).

Solution: Install yfinance using Pip or Conda (Primary Methods)​

  • Using pip (Standard Python Package Installer): Open your terminal or command prompt. If using a virtual environment, ensure it's activated.

    # Standard pip install
    pip install yfinance

    # If you use Python 3 and might have Python 2 pip on PATH:
    pip3 install yfinance

    # To ensure you use pip associated with a specific python interpreter (recommended):
    python -m pip install yfinance
    python3 -m pip install yfinance
    py -m pip install yfinance      # Windows Python Launcher

    # If you encounter permission errors (less ideal than venvs or --user for global installs):
    # pip install yfinance --user   # Installs to user site-packages
    # sudo pip3 install yfinance    # Linux/macOS global install (use with caution)

  • Using conda (If using Anaconda/Miniconda): While yfinance is available on PyPI (for pip), for Conda users, it's often recommended to install using pip within the Conda environment, or check for specific Conda channels if they provide a yfinance package. The original article mentioned pip install -i https://pypi.anaconda.org/ranaroussi/simple yfinance for Anaconda, which suggests installing via pip from a specific index sometimes maintained for Anaconda users. However, a direct pip install yfinance within an active conda environment usually works.

    # Activate your conda environment first: conda activate your_env_name

    # Using pip inside Conda (most common for yfinance)
    pip install yfinance

    # Alternatively, check if a conda package exists (less common for yfinance)
    # conda install -c some_channel yfinance # Replace some_channel if known

After successful installation, your import yfinance as yf statement should work.

# Example usage after installation
import yfinance as yf

try:
    msft = yf.Ticker("MSFT")
    print("Microsoft (MSFT) Info:")
    print(msft.info.get('longName', 'N/A'), msft.info.get('currentPrice', 'N/A'))

    # Get historical market data
    # hist = msft.history(period="1mo")
    # print("\nMSFT 1 Month History (Head):")
    # print(hist.head())
except Exception as e:
    print(f"An error occurred: {e}")

Platform-Specific Installation Instructions​

The core installation command is usually pip install yfinance. Accessing the terminal is the main difference.

Windows (Command Prompt / PowerShell)​

  1. Open Command Prompt (type cmd in search) or PowerShell.
  2. Run: 
    pip install yfinance
    # Or if multiple Pythons/PATH issues:
    # py -m pip install yfinance
  3. For global installs with permission issues (not recommended), run as Administrator or use pip install yfinance --user. Virtual environments are preferred (see Section 5).

macOS / Linux (Terminal)​

  1. Open your Terminal application.
  2. Run: 
    pip3 install yfinance # Usually best for Python 3
    # Or:
    # python3 -m pip install yfinance
  3. For global installs with permission issues (not recommended), use sudo pip3 install yfinance or pip3 install yfinance --user. Virtual environments are strongly preferred.

IDE and Notebook Specific Installation​

Visual Studio Code (Integrated Terminal)​

  1. Open the integrated terminal (Ctrl+` or View -> Terminal).
  2. Ensure the correct Python interpreter (especially your virtual environment's) is selected for your workspace. VS Code shows this in the bottom status bar.
  3. Run: pip install yfinance

PyCharm (Terminal / Package Manager GUI)​

  • Terminal: Open the Terminal tool window (Alt+F12). Ensure it's using your project's configured interpreter. Run: pip install yfinance.
  • Package Manager GUI:
    1. File -> Settings (or PyCharm -> Preferences) -> Project: [Your_Project_Name] -> Python Interpreter.
    2. Click the + icon. Search for yfinance. Select it and click "Install Package".

Anaconda / Conda Environments​

  1. Open Anaconda Prompt or your terminal (with Conda in PATH).
  2. Activate your target environment: conda activate your_env_name
  3. Install using pip (most common for yfinance): 
    pip install yfinance
    # The original article's Anaconda command:
    # pip install -i https://pypi.anaconda.org/ranaroussi/simple yfinance
    # This forces pip to use a specific index; usually not needed unless PyPI is blocked/problematic.

Jupyter Notebook / Lab​

  • Method 1 (Recommended - Install Before Starting): Activate the correct Python environment (venv or conda) in your terminal, run pip install yfinance, then start Jupyter.
  • Method 2 (Install from Notebook Cell): 
    !pip install yfinance
    # OR (if using a conda environment as the kernel and preferring pip):
    !conda run -n your_conda_env_name pip install yfinance
    Important: After installing this way, restart the kernel (Kernel menu -> Restart Kernel...).

Using a virtual environment for each project is the best way to manage dependencies and avoid ModuleNotFoundError.

  1. Create (in your project folder): 
    python3 -m venv yfinance_env # Example name
  2. Activate: (OS-specific commands: source yfinance_env/bin/activate, yfinance_env\Scripts\activate.bat, etc.)
  3. Install yfinance: 
    pip install --upgrade pip # Good practice
    pip install yfinance

Verifying the Installation (pip show yfinance)​

After installation, verify it in the same terminal/environment where you intend to use it:

pip show yfinance

This displays information about the installed yfinance package.

Troubleshooting Persistent ModuleNotFoundError​

If you've installed yfinance but still get the error:

  • Environment Mismatch: You installed yfinance in one Python environment but are running your script/notebook using a different one.
    • Solution: Ensure your script, IDE interpreter, or Jupyter kernel uses the exact same Python environment where yfinance was successfully installed.
  • Incorrect pip: You might have used a pip command associated with a different Python installation.
    • Solution: Always use python -m pip install ... or python3 -m pip install ....
  • Filename Shadowing: Do not name any of your local Python files yfinance.py in your project.
  • Variable Shadowing: Avoid using yfinance as a variable name before import yfinance.
  • Restart: After installation, restart your IDE, terminal, or Jupyter kernel.
  • Reinstall the Package: 
    pip uninstall yfinance -y
    pip install yfinance --no-cache-dir # --no-cache-dir for fresh download

Conclusion​

The ModuleNotFoundError: No module named 'yfinance' typically means the yfinance package isn't installed in the Python environment your script is using.

The primary solution is to install yfinance using pip:

pip install yfinance

Crucially, ensure this installation happens within the correct, active Python environment, preferably an isolated virtual environment. If issues persist, meticulously verify your Python/pip paths, IDE interpreter settings, and ensure no local files or variables are shadowing the yfinance package name.

Table of Contents