Installation from Source

To contribute and submit changes to Stoobly, you must first install from the source code.


Install poetry with the following command:

curl -sSL | python3 -


  1. Download the agent source code:

git clone
  1. Change your directory to where you cloned it and run the install command:

poetry install


To start the agent, run:

poetry run stoobly-agent run

The above command will expose the proxy on port 8080 and the UI on port 4200

  • If the proxy port conflicts, configure it with the --proxy-port INTEGER flag

  • If the UI port conflicts, configure it with --ui-port INTEGER flag

Then you should see output like this to indicate that it started up successfully:

UI server listening at

Loading script /home/user/.local/lib/python3.8/site-packages/stoobly_agent/app/proxy/
Proxy server listening at http://*:8080

Last updated