# What Are the Supported Python Versions for DeusData codebase-memory-mcp?

> Explore the Python versions supported by DeusData codebase-memory-mcp. This package works with Python 3.8 and newer, including all releases up to 3.12 and beyond.

- Repository: [Martin Vogel/codebase-memory-mcp](https://github.com/DeusData/codebase-memory-mcp)
- Tags: api-reference
- Published: 2026-07-25

---

**The DeusData codebase-memory-mcp package requires Python 3.8 or newer, supporting all subsequent CPython releases through 3.12 and beyond.**

The `codebase-memory-mcp` library defines its Python compatibility constraints in the package manifest. According to the DeusData/codebase-memory-mcp source code, attempting to install or import the library on Python 3.7 or earlier will fail with a version error.

## How Python Version Requirements Are Defined

The authoritative source for supported Python versions resides in [`pkg/pypi/pyproject.toml`](https://github.com/DeusData/codebase-memory-mcp/blob/main/pkg/pypi/pyproject.toml). At line 11 of this manifest, the `requires-python` field explicitly sets the minimum version:

```toml
requires-python = ">=3.8"

```

This directive signals to packaging tools like **pip** and **poetry** that the library is compatible with Python 3.8, 3.9, 3.10, 3.11, 3.12, and any future 3.x releases. Installers will automatically block installation on Python 3.7 or earlier environments.

## Verifying Your Python Version Compatibility

Before importing the library, you can programmatically validate your interpreter version to prevent runtime errors. This check ensures you meet the `>=3.8` requirement specified in the [`pyproject.toml`](https://github.com/DeusData/codebase-memory-mcp/blob/main/pyproject.toml):

```python
import sys

# Ensure we are running on at least Python 3.8

if sys.version_info < (3, 8):
    raise RuntimeError(
        "codebase-memory-mcp requires Python 3.8 or newer (detected "
        f"{sys.version_info.major}.{sys.version_info.minor})"
    )

```

## Installation Behavior on Unsupported Versions

When you install via pip on a supported interpreter, the command executes normally:

```bash

# Works on Python >=3.8

python -m pip install codebase-memory-mcp

```

However, if you attempt installation with Python 3.7 or older, pip enforces the `requires-python` constraint and aborts with the following error:

```

ERROR: Package 'codebase-memory-mcp' requires a different Python version (>=3.8)

```

This safeguard prevents incompatible environments from installing the package.

## Runtime Verification After Installation

Once installed on a valid Python version, you can confirm the package is accessible and check its version through the public API exposed in [`pkg/pypi/src/codebase_memory_mcp/__init__.py`](https://github.com/DeusData/codebase-memory-mcp/blob/main/pkg/pypi/src/codebase_memory_mcp/__init__.py):

```python
from codebase_memory_mcp import __version__

print(f"codebase-memory-mcp version: {__version__}")

# → codebase-memory-mcp version: 0.1.0   (example)

```

## Summary

- **Minimum version**: Python 3.8 (defined in [`pyproject.toml`](https://github.com/DeusData/codebase-memory-mcp/blob/main/pyproject.toml) line 11)
- **Maximum version**: No upper bound specified; compatible with all Python 3.x releases newer than 3.8
- **Blocking mechanism**: pip automatically prevents installation on Python 3.7 or earlier
- **Key file**: [`pkg/pypi/pyproject.toml`](https://github.com/DeusData/codebase-memory-mcp/blob/main/pkg/pypi/pyproject.toml) contains the canonical `requires-python` declaration

## Frequently Asked Questions

### Can I use codebase-memory-mcp with Python 3.7?

No. The package strictly requires Python 3.8 or newer. If you attempt to install on Python 3.7, pip will reject the installation with a version conflict error because the [`pyproject.toml`](https://github.com/DeusData/codebase-memory-mcp/blob/main/pyproject.toml) specifies `requires-python = ">=3.8"`.

### What is the minimum Python version required for codebase-memory-mcp?

Python 3.8 is the minimum supported version. This requirement is hard-coded in the package metadata at [`pkg/pypi/pyproject.toml`](https://github.com/DeusData/codebase-memory-mcp/blob/main/pkg/pypi/pyproject.toml) line 11, ensuring compatibility with modern type hinting and async features used in the library.

### Is Python 3.12 supported by codebase-memory-mcp?

Yes. Since the `requires-python` field uses the `>=3.8` specifier without an upper bound, Python 3.12, 3.13, and subsequent 3.x releases are officially supported. The package will install and run on any CPython version 3.8 or higher.

### How do I check if my Python environment is compatible with codebase-memory-mcp?

Run `python --version` in your terminal to verify you are using Python 3.8+. Alternatively, use the `sys.version_info` check shown in the code examples above to validate compatibility before attempting to import the library.