Mach 30 Distributed OSHW Framework Workspace (Kasm Image)

Introduction

This repo provides a workspace for Mach 30 volunteers to work on Mach 30 Modeling Language, Mach 30 Project Manager, the Distributed OSHW Framework (DOF), and Sliderule based on the Ansible based template for KASM Ubuntu Focal Images template provided by @j-simmons-phd. The workspace is configured with the following software:

• Node JS Tools
  • nodejs v20.11.1
  • npm v10.2.4 (included with nodejs)
  • npx v10.2.4 (included with nodejs)
  • yarn v3.5.0
  • oclif v3.10.0
  • cli-njk v1.0.0
• Utilities
  • git v2.25.1 with @capsulecorplab .gitconfig
  • gradle v8.1.1
  • Keychain v2.8.5
  • Vim (pre-installed) with @capsulecorplab vimrc
  • yamllint v1.31.0
• Python Based Tools
  • Jupyter Lab
  • Juptyer Notebook
  • Voila
  • Pint
  • LinkML v1.6.0
  • Poetry (latest)
• Artifact Generators
  • Pandoc v2.17.0.1
  • TeX Live v2019 to enable PDF support in Pandoc
  • yq v4.33.2
  • PlantUML
    • JDK v11
    • Graphviz 2.50 (built from source)
  • AsciiDoctor v2.0.18 with PlantUML and PDF support
• VS Code v1.77.3 with the following extensions
  • Node.js Extension Pack
  • YAML Language Support by Red Hat
  • PlantUML
  • AsciiDoc support for Visual Studio Code
  • Dendron
  • Gradle for Java
  • Better Jinja
  • Python
  • Markdown All in One
• Knowledge Capture Tools
  • JabRef v5.5.6
• Pharo
• Content Viewers
  • Chrome
  • Firefox
  • Evince Document Reader

A Note on Licensing

This repo includes code and packages from a number of outside sources (including Kasm Workspaces). The project license file only covers code written by the project author and contributors. All other code is subject to its authors' terms and conditions.

How to Use this Repo

1. Download and unzip the latest release
2. Open the unzipped release folder in the command line
3. Run docker-compose pull to download the image

Using the image locally

Once built, the image can be pushed into the Kasm server per Kasm documentation or it can be run locally on port 6901 using docker-compose.

• Starting the image locally: Run docker-compose up -d
• Stopping the image locally: Run docker-compose down

When running locally, the workspace can be accessed at https://localhost:6901 with

• User: kasm_user
• Passwordd: password