Skip to main content

Sorna agent

Project description

Package Structure

  • sorna
    • agent: The agent daemon implementation


Sorna Agent requires Python 3.5 or higher. We highly recommend to use pyenv for an isolated setup of custom Python versions that might be different from default installations managed by your OS or Linux distros.

pip install sorna-agent

Due to limitation in current version (9.0.1) of pip, you may encounter errors while installing aiodocker. In that case, run pip install -r requirements.txt and try again.

For development:

We recommend to use an isolated virtual environment. This installs the current working copy and sorna-common as “editable” packages.

git clone
python -m venv venv-sorna
source venv-sorna/bin/activate
pip install -U pip setuptools wheel  # ensure latest versions
pip install -r requirements-dev.txt


Running from a command line:

To handle uploads of generated files to AWS S3, you need to set several environment variables. If they are not set, the file upload feature is disabled. Currently we only support S3-based uploads.

export AWS_ACCESS_KEY_ID="..."
export AWS_REGION="..."     # e.g., ap-northeast-2
export AWS_S3_BUCKET="..."  # e.g., my-precious-sorna
python -m sorna.agent.server --manager-addr tcp://localhost:5001 --max-kernels 15

For details about arguments, run the server with --help.

Example supervisord config:

stopsignal = TERM
stopasgroup = true
command = /home/sorna/
environment = AWS_ACCESS_KEY_ID="...",AWS_SECRET_ACCESS_KEy="...",AWS_REGION="...",AWS_S3_BUCKET="..."

TCP Port numbers to open against the manager

  • 6001: ZeroMQ-based internal agent control protocol.

  • The containers will open arbitrary ports for their local 2000-2003 ports for REPL I/O and TTY I/O.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sorna-agent-0.9.14.tar.gz (18.6 kB view hashes)

Uploaded source

Built Distribution

sorna_agent-0.9.14-py36-none-any.whl (25.8 kB view hashes)

Uploaded py36

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page