Sorna meta-package
Project description
Sorna (“Software on Remote Networking Appliances”) is a distributed back-end computation service with highly abstracted API. Unlike AWS Lambda, it provides a preset of kernel images representing various programming environments and allows users to execute their code snippets without a cumbersome packaging process. All sub-projects are licensed under LGPLv3+.
Server-side Components
Sorna API Gateway
It routes external API requests from front-end services to agent instances by checking the instance registry.
Package namespace: sorna.gateway, sorna.manager
Sorna Agent
It manages individual EC2 instances and launches/destroyes Docker containers where REPL daemons (kernels) run. Each agent on a new EC2 instance self-registers itself to the instance registry via heartbeats.
Package namespace: sorna.agent
Sorna REPL
A set of small ZMQ-based REPL daemons in various programming languages and configurations. It also includes a sandbox implemented using ptrace-based sytem call filtering written in Go.
Each daemon is a separate program, usually named “run.{lang-specific-extension}”.
Sorna Common
A collection of utility modules commonly shared throughout Sorna projects, such as logging and messaging protocols.
Package namespaces: sorna.proto, sorna
Client-side Components
Sorna Client
A client library to access the Sorna API servers with ease.
Package namespaces: sorna.client
Sorna Jupyter Kernel
Jupyter kernel integration of the Sorna Cloud API.
Package namespaces: sorna.integration
Sorna Media
The front-end support libraries to handle multi-media outputs (e.g., SVG plots, animated vector graphics)
The Python package (sorna) is installed inside kernel containers.
To interpret and display media generated by the Python package, you need to load the Javascript part in the front-end.
Installation
The Sorna project uses latest features in Python 3.6+ and docker. We highly recommend to use pyenv to use an isolated setup with custom Python versions that might not be supported by your
First, install Docker on your system. We have tested Sorna on Linux/Ubuntu and macOS (“Docker for Mac”).
For a single PC setup, just run pip install sorna. It will automatically install all above sub-projects as well as their dependencies.
Development
git flow
The sorna repositories use git flow to streamline branching during development and deployment. We use the default configuration (master -> preparation for release, develop -> main development, feature/ -> features, etc.) as-is.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
