This repository has been archived by the owner. It is now read-only.
Easy-as RPC. Zero-server RPC for Python and Java.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Pushy is an RPC (Remote Procedure Call) package for Python and Java. The key feature of Pushy is that it only requires Python and an SSH daemon on the "server". You don't need to install anything on the remote machine, which makes Pushy useful for controlling remote systems without installing custom software on them.

The core of Pushy is written in and for Python, and a Java API is provided that sits on top of this. The Java API allows developers to write Java code that interacts local or remote Python (plain old CPython, not Jython) interpreters, providing Java abstractions around Python modules, that will be more familiar to Java developers.


First, install Pushy by one of several methods:

  • Using pip: pip install pushy
  • Grab the source archive from the PyPI page, and run the usual: python install
  • Java users only: Grab the jar file for Java and add it to your classpath. It's self-contained (Java and Python code together.)

Python Example

Now you're ready to create a Pushy connection. In the example below, we create a connection to a remote machine and list the directories in the home directory of the user 'me'. In accessing an attribute of a connection's "modules", you are effectively "importing" the remote module of that name. A proxy to that module is returned, and from then on you can (more or less) treat the module as if it were locally defined.

import pushy
with pushy.connect("ssh:remotehost", username="me", password="password") as conn:
    for (root,dirs,files) in conn.modules.os.walk("."):
        for d in dirs:
            print conn.modules.os.path.join(root, d)
        for f in files:
            print conn.modules.os.path.join(root, f)

Java Example

To do this from a Java program, you write code very similar to how you would if you were writing it for the local machine. The Pushy Java API provides a means of interrogating the remote system's properties, using a similar API to java.lang.System. This can be used to obtain the current working directory; with that in hand, can be used in a similar way as to list files.

import java.util.Properties;

public class ListFiles {
    public static void main(String[] args) throws Exception {
        Properties props = new Properties();
        props.setProperty("username", "me");
        props.setProperty("password", "password");
        pushy.Client client = new pushy.Client("ssh:remotehost", props);
        try {
            pushy.RemoteSystem system = client.getSystem();
            String cwd = system.getProperty("user.dir");
   dir = new, cwd);
            for ( file : dir.listFiles()) {
        } finally {


Further documentation can be found at If you can't find what you're looking for, please create an Issue.