aiosmb

library0.4.14pypypiunverified

aiosmb is an asynchronous Python implementation of the SMB (Server Message Block) protocol, supporting SMBv2 and SMBv3. It enables high-level client connections and low-level packet manipulation. Current version 0.4.14 supports Python >=3.7. It is actively maintained and released ad-hoc.

devops

pip install aiosmb

github ↗homepage ↗

INSTALL

IMPORT

SIG · AIOSMB

aiosmb

devopspythonv0.4.14

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

SMBConnection

✓ from aiosmb import SMBConnection

✗ from aiosmb import SMBConnection

Establishes an SMB connection and authenticates.

import asyncio from aiosmb import SMBConnection async def main(): conn = SMBConnection( target='192.168.1.1', username='user', password='pass', domain='WORKGROUP', port=445, auth='ntlm' ) await conn.authenticate() print('Authenticated') await conn.close() asyncio.run(main())

Debug

Known issues

breakingIn 0.4.x, `SMBClient` was moved from `aiosmb.client` to `aiosmb.compat`. Old imports will fail.

fix

Use `from aiosmb.compat import SMBClient` instead of `from aiosmb.client import SMBClient`.

affects: >=0.4.0

deprecatedThe `SMBConnection.authenticate()` method no longer returns the session; it returns a boolean in 0.4.14.

fix

Check the return value: `if await conn.authenticate(): ...`.

affects: >=0.4.0

gotchaThe library uses asyncio; mixing with synchronous code requires careful event loop management or use of `asyncio.run()`.

fix

Always run within an async context. Use `asyncio.run()` or `await` properly.

affects: all

gotchaWhen using SMBv3, encryption must be enabled explicitly; otherwise, traffic is unencrypted.

fix

Set `encrypt=True` in SMBConnection parameters to force encryption.

affects: all

Upgrade

Version history

0.4.14latest on PyPI · released Oct 29, 2025

Audit

Dependencies

asysocksoptionalrequired for SOCKS proxy support

pysocksoptionalalternative SOCKS support

Agent activity

36 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/skelsec/aiosmb ↗

homepagehttps://github.com/skelsec/aiosmb ↗