paramiko: ssh2 protocol for python

paramiko
SSH2 protocol for python

last updated 06-Jul-2008

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

Clara

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
10 Jun 2007	paramiko 1.7.1 "Amy" released bug fixes
18 Feb 2007	paramiko 1.7 "zubat" released x11 and reverse port forwarding 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.4.zip "Desmond" (signature)
MD5 = cea5c1d8c2aa9f4fb298a89fa3468807
paramiko-1.7.4.tar.gz "Desmond" (signature)
MD5 = 6ae82f2eb30748be789d4ff3909e4b5e
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://www.lag.net/paramiko/bzr/paramiko/
the source code is kept in a bazaar (bzr) archive. fetching the source is as simple as:
```
    $ bzr branch http://www.lag.net/paramiko/bzr/paramiko/
```
browse the source using loggerhead
my public GPG key

free banner!