---
id: pyscard
version: "2.3.1"
license: unclear
license_treatment: copyleft
maintenance: active
---

# pyscard — Smartcard module for Python.

License: copyleft · Maintenance: active · Downloads: 84.4K/mo

## What it is and what it does

pyscard is a Python library that bridges your application to smartcard readers and the cards themselves. It provides both high-level and low-level APIs for reading card data, executing commands, and managing authentication workflows. The library wraps the underlying platform smartcard infrastructure and exposes it through Python, so you can enumerate readers, establish connections, and send commands without dealing directly with system-level card interfaces.

The package is production-stable and actively maintained, supporting Python 3.9 through 3.13 with prebuilt wheels for Windows, macOS, and Unix. Its single runtime dependency is typing_extensions, keeping the footprint minimal. It's useful for applications that need to interact with government ID cards, payment cards, security tokens, or other smartcards.

Use it for:

- Read and verify data from government-issued ID cards or passports in identity verification workflows.
- Implement smartcard-based authentication for secure access control or two-factor authentication systems.
- Build payment or banking applications that interact with credit or debit cards.
- Develop security token management tools that communicate with hardware security modules.
- Create diagnostic or testing utilities for smartcard reader hardware and card compatibility validation.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

pyscard provides Python bindings to interact with smartcard readers and cards, enabling applications to read, write, and authenticate using physical smartcards.

Yes, if you need to interact with smartcards. The library is production-stable, actively maintained, has no known vulnerabilities, and supports modern Python versions. Install friction is moderate due to platform-specific dependencies, but prebuilt wheels are available. The copyleft license (LGPLv2+) is standard for this domain and poses no barrier for most use cases.

## Install

pip install pyscard
uv add pyscard
poetry add pyscard

## Installing pyscard

Before you install: Medium install friction due to platform-specific wheels and compiled dependencies; however, prebuilt wheels are available for Windows, macOS, and Unix across Python 3.9–3.13, reducing build complexity. The package is actively maintained with a recent release.

License in practice: Licensed under LGPLv2+, a copyleft license requiring derivative works to be distributed under compatible terms; acceptable for most applications but review required if you plan to distribute proprietary modifications.

Quickstart:

pip install pyscard

import pyscard

# Use pyscard to enumerate and connect to smartcard readers
# See https://pyscard.sourceforge.io/pyscard-framework.html#framework-samples

Requires a smartcard reader device connected to the system; the underlying smartcard subsystem must be installed and running on your platform.

Verify before relying:

- Whether the package supports NFC/contactless cards or only contact-based smartcards.
- Performance characteristics and latency for high-frequency card operations.
- Compatibility with specific smartcard standards and card types beyond general support.
- Exact API surface and available methods for card communication and data access.

## Package facts

- License: not declared (copyleft)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 84.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

smartcard reader python, smart card library, python smartcard interface, card reader integration, smartcard authentication, python chip card support, hardware security token, smartcard-hardware, authentication

[View on SkillFed](https://skillfed.io/packages/pyscard) · [View on PyPI](https://pypi.org/project/pyscard/)