paramiko: ssh2 protocol for python

paramiko
SSH2 protocol for python

last updated 01-Nov-2009

paramiko is a module for python 2.2 (or higher) that implements the SSH2 protocol for secure (encrypted and authenticated) connections to remote machines. unlike SSL (aka TLS), SSH2 protocol does not require heirarchical certificates signed by a powerful central authority. you may know SSH2 as the protocol that replaced telnet and rsh for secure access to remote shells, but the protocol also includes the ability to open arbitrary channels to remote services across the encrypted tunnel -- this is how sftp works, for example.

it is written entirely in python (no C or platform-dependent code) and is released under the GNU LGPL (lesser GPL).

there is now also a java port.

news

Fanny

01 Nov 2009	paramiko 1.7.6 "Fanny" released various bug fixes
19 Jul 2009	paramiko 1.7.5 "Ernest" released ARC4 & CTR support, IP6 support, and various bug fixes
06 Jul 2008	paramiko 1.7.4 "Desmond" released bug fixes, including an important Windows random number generation fix
23 Mar 2008	paramiko 1.7.3 "Clara" released many bug fixes
21 Jan 2008	paramiko 1.7.2 "Basil" released direct-tcpip support; bug fixes

download

milestone releases are being named alphabetically after children from edward gorey's "gashlycrumb tinies". previously they were named after pokémon.

paramiko-1.7.6.zip "Fanny" (signature)
MD5 = 66c7328ddd72932f445a69e3d7ad5a1d
paramiko-1.7.6.tar.gz "Fanny" (signature)
MD5 = fa144ab46f1dc639b05ab948c30efac4
older releases

pre-built packages for some systems are maintained by external sites:

Red Hat/Fedora RPMs (from DAG)
Red Hat/Fedora RPMs (from Dries)
Debian (in unstable)
Ubuntu (in gutsy)

the Debian and Ubuntu packages are often months out of date. sorry, it's out of my control.

requirements

platforms supported: POSIX (Linux, Solaris, BSD, etc.); MacOS X; Windows
python 2.3: python 2.2 is also supported, but not recommended.
pycrypto 1.9+: pycrypto 2.0 has been tested too.

documentation

there is extensive online API documentation.
check out the demo scripts in the distribution.
there's also a low-volume mailing list.

development

i happily accept patches, either via email to the mailing list, or by merging if you have a branch.

project/bugs: http://launchpad.net/products/paramiko
source repository: http://github.com/robey/paramiko/

free banner!