Skip to main content

How to Install sympy for Symbolic Mathematics in Python

SymPy is a powerful Python library for symbolic mathematics. It enables you to perform algebraic manipulations, calculus, solve equations, and work with mathematical symbols in a programmatic way. Before you can use SymPy in your projects, you need to install it. If you try to import sympy without proper installation or in the wrong environment, you'll encounter the ModuleNotFoundError: No module named 'sympy'.

This guide provides comprehensive instructions on how to install sympy using pip and conda across various platforms and IDEs, and how to troubleshoot the ModuleNotFoundError.

What is SymPy?​

SymPy is a Python library for symbolic computation. Unlike numerical libraries like NumPy that work with approximate numerical values, SymPy works with mathematical symbols and expressions exactly. It can be used for:

  • Algebra: Simplifying expressions, solving equations, working with polynomials.
  • Calculus: Derivatives, integrals, limits, series expansions.
  • Matrices: Symbolic matrix operations.
  • Discrete math, geometry, plotting, and more.

It aims to be a full-featured computer algebra system (CAS) while keeping the code as simple as possible to be comprehensible and easily extensible.

Solving ModuleNotFoundError: No module named 'sympy'​

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

Cause: Package Not Installed or Incorrect Environment​

The most common reasons are:

  • You haven't installed sympy yet.
  • You installed sympy 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 sympy 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 sympy

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

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

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

  • Using conda (If using Anaconda/Miniconda): SymPy is available in the default Anaconda channel and conda-forge.

    # Activate your conda environment first: conda activate your_env_name
    conda install -c anaconda sympy

    # Or from conda-forge (often more up-to-date):
    conda install -c conda-forge sympy

After successful installation, your import sympy statement should work.

Platform-Specific Installation Instructions​

The core installation command (pip install sympy or conda install sympy) is the same, but terminal access and environment specifics vary.

Windows (Command Prompt / PowerShell)​

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

macOS / Linux (Terminal)​

  1. Open your Terminal application.
  2. Run: 
    pip3 install sympy # Usually best for Python 3
    # Or:
    # python3 -m pip install sympy
  3. For global installs with permission issues (not recommended), use sudo pip3 install sympy or pip3 install sympy --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, and the terminal should use this environment.
  3. Run: pip install sympy

PyCharm (Terminal / Package Manager GUI)​

  • Terminal: Open the Terminal tool window (Alt+F12). Ensure it's using your project's configured interpreter (often a venv). Run: pip install sympy.
  • Package Manager GUI:
    1. File -> Settings (or PyCharm -> Preferences) -> Project: [Your_Project_Name] -> Python Interpreter.
    2. Click the + icon.
    3. Search for sympy.
    4. 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 conda (preferred within Conda ecosystem): 
    conda install -c anaconda sympy
    # Or from conda-forge:
    # conda install -c conda-forge sympy
    If a suitable Conda package isn't found, you can use pip inside the active Conda environment: pip install sympy.

Jupyter Notebook / Lab​

  • Method 1 (Recommended - Install Before Starting): Activate the correct Python environment (venv or conda) in your terminal, run pip install sympy (or conda install ...), then start Jupyter. The notebook should use that environment's kernel.
  • Method 2 (Install from Notebook Cell): 
    # In a code cell:
    !pip install sympy
    # OR (if using a conda environment as the kernel):
    !conda install -c anaconda sympy -y
    note

    Important: After installing via !pip or !conda, you must restart the kernel (Kernel menu -> Restart Kernel...) for the notebook to recognize the newly installed sympy package.

Using a virtual environment for each project is the best way to manage dependencies and avoid ModuleNotFoundError due to packages being installed in the wrong global scope.

  1. Create (in your project folder): 
    python3 -m venv sympy_env # Example name, or use 'python' or 'py'
  2. Activate: 
    # Linux/macOS:
    source sympy_env/bin/activate
    # Windows CMD:
    # sympy_env\Scripts\activate.bat
    # Windows PowerShell:
    # sympy_env\Scripts\Activate.ps1
  3. Install sympy: 
    # Prompt shows (sympy_env)
    pip install --upgrade pip # Good practice
    pip install sympy

Verifying the Installation (pip show sympy)​

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

pip show sympy
# Or: 
python -m pip show sympy

This command displays information about the installed sympy package, including its version and location.

Troubleshooting Persistent ModuleNotFoundError​

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

  • Environment Mismatch: You installed sympy 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 sympy was successfully installed. Activating the correct virtual environment is key.
  • 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 ... (or py -m pip ... on Windows) to ensure pip corresponds to the active python interpreter.
  • Filename Shadowing: Do not name any of your local Python files sympy.py in your project. This will interfere with importing the actual library.
  • Variable Shadowing: Avoid using sympy as a variable name before import sympy.
  • Restart: After installation, especially if done while an IDE or Jupyter kernel was running, restart the IDE/kernel.
  • Reinstall the Package: 
    pip uninstall sympy -y
    pip install sympy --no-cache-dir # --no-cache-dir for fresh download

Conclusion​

The ModuleNotFoundError: No module named 'sympy' typically means the sympy package is not installed in the Python environment your script is currently using, or there's a path/environment configuration issue.

The primary solution is to install sympy using pip or conda:

pip install sympy
# OR (for Conda users)
conda install -c anaconda sympy

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

Table of Contents