README.md

Tetra Workspace (Kasm Image)

Introduction

This repo provides an Immutable-Infrastructure-as-Code (IIaC) workspace based on the KASM Ubuntu Jammy Image for Tetra Bio Distributed's medical/PPE open-source hardware (OSHW) development. The workspace is configured with the following software:

• Utilities
  • git 2.42.0
  • Keychain
  • Vim (pre-installed) with @capsulecorplab vimrc
• Firefox
• Python 3.10 (part of the image template) with the following packages (not part of the image template)
  • pip
  • JupyterLab
  • Jupyter Notebook
  • Pint
  • LinkML
  • Jinja2
  • pyserial
• VS Code with the following extensions (note, auto-updates are disabled)
  • Python extension by Microsoft
  • LaTeX Workshop
• OSHW Design Tools
  • Arduino 1.8.19
    • Arduino CLI 0.33.0
    • Arduino Pico 3.3.0
    • Arduino ESP32 2.0.9
  • KiCAD 7.0.10
  • FreeCAD 0.21.2
  • PrusaSlicer 2.7.1

How to Use this Repo

1. Clone this repo
2. Run docker-compose pull to download the image or run docker-compose build to build the workspace 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