pysmb
pysmb is an experimental SMB/CIFS library written in Python to support file sharing between Windows and Linux machines
Decision gist · record as of 2026-08-14
Yes, if you need SMB/CIFS file access from Python and can tolerate the experimental label. Low install friction, permissive license, active maintenance, and no known vulnerabilities make it a reasonable choice. Verify that the protocol coverage and Python version support match your requirements before committing to production use.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires network access to an SMB/CIFS server; valid credentials and firewall rules are prerequisites for file operations.
- Low install friction with only 2 runtime dependencies (pyasn1, tqdm).
- Active maintenance with a release 6 days ago signals ongoing support.
License · maintenance · safety
zlib/libpng (permissive) — Licensed under zlib/libpng, a permissive license that allows commercial and private use with minimal restrictions—suitable for most projects.
last release 2026-08-08 (6 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 2,863,617 downloads/mo, #2,856 on PyPI
Alternatives
Verify before relying
pip install pysmb
import pysmb
# Connect to an SMB server with credentials and client name
# then list or transfer files on the remote share- Whether Python 2 support (classifiers list 2.4–2.7) is still functional or merely legacy metadata.
- Current test coverage and whether experimental status reflects incomplete protocol implementation.
- Performance characteristics and suitability for high-throughput or large-file scenarios.
- Specific API surface and which SMB/CIFS operations are fully implemented versus partial.
What it is and what it does
pysmb is a pure-Python SMB/CIFS client library that lets you connect to and interact with Windows file shares and Samba folders from Python code. It handles the protocol negotiation and file operations needed to list directories, read files, write files, and manage shares on remote SMB servers—useful for cross-platform automation, backup scripts, and applications that need to integrate with Windows network infrastructure.
The library depends on pyasn1 for ASN.1 encoding and tqdm for progress indication. It is classified as Production/Stable and has been maintained since 2011, though it is labeled experimental in its description. The package supports both Windows and POSIX systems and carries no known security vulnerabilities.
Use it for
- Automate file transfers to and from Windows network shares in Python scripts or applications.
- Build cross-platform backup or synchronization tools that access Samba or Windows file servers.
- List and inspect remote SMB share contents programmatically without mounting the share locally.
- Integrate Windows file sharing into headless Linux or cloud-based Python applications.
- Test SMB/CIFS client behavior in CI/CD pipelines against mock or real SMB servers.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need SMB/CIFS file access from Python and can tolerate the experimental label.
Low install friction, permissive license, active maintenance, and no known vulnerabilities make it a reasonable choice. Verify that the protocol coverage and Python version support match your requirements before committing to production use.
Install
pysmb on PyPI
Before you install
Low install friction with only 2 runtime dependencies (pyasn1, tqdm). Active maintenance with a release 6 days ago signals ongoing support.
Requires network access to an SMB/CIFS server; valid credentials and firewall rules are prerequisites for file operations.
License in practice
Licensed under zlib/libpng, a permissive license that allows commercial and private use with minimal restrictions—suitable for most projects.
Quickstart
pip install pysmb
import pysmb
# Connect to an SMB server with credentials and client name
# then list or transfer files on the remote shareVerify before relying
- Whether Python 2 support (classifiers list 2.4–2.7) is still functional or merely legacy metadata.
- Current test coverage and whether experimental status reflects incomplete protocol implementation.
- Performance characteristics and suitability for high-throughput or large-file scenarios.
- Specific API surface and which SMB/CIFS operations are fully implemented versus partial.
Package facts
| License | zlib/libpng permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagespyasn1tqdm |
| Maintenance | Actively maintained 6 days since the last release |
| First released | |
| Downloads | 2,863,617 / month, #2,856 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: ConsoleEnvironment :: Win32 (MS Windows)License :: OSI Approved :: zlib/libpng LicenseOperating System :: Microsoft :: WindowsOperating System :: POSIXProgramming Language :: PythonProgramming Language :: Python :: 2.4Programming Language :: Python :: 2.5Programming Language :: Python :: 2.6Programming Language :: Python :: 2.7Programming Language :: Python :: 3Topic :: Communications :: File SharingTopic :: Software Development :: Libraries :: Python ModulesTopic :: System :: Networking |
Evidence: pysmb-1.2.15-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “smb file sharing python”
- pysmbpysmb implements the SMB/CIFS protocol to let Python applications…
- smbprotocolSMBv2 and SMBv3 client library for Python that enables reading,…
- azure-storage-file-shareInteract with Azure File Share storage—create, read, update, and…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also smbprotocol · apache-airflow-providers-samba · azure-storage-file-share · magic-wormhole · pypsexec · impacket · pyminizip · WMI · pyftpdlib · bacpypes