tsh

Tangible Shell for launching Halgorithem in a temporary Docker sandbox.

Whats tsh

tsh is a small command-line shell for Tangible tools. Right now, it connects to Halgorithem by cloning the Halgorithem repository into a disposable Docker container, installing the needed Python dependencies, and launching the Halgorithem terminal UI.

How does tsh Work

tsh checks for internet access, starts a lightweight Python Docker container, clones Halgorithem from GitHub, installs the verifier dependencies, patches the sandbox to use lightweight local scoring, and opens tui.py.

Key Features

• Launches Halgorithem in Docker
  tsh keeps the Halgorithem runtime isolated from your local Python environment.

• Simple shell command
  Run connect Halgo from the interactive shell or pass it directly as a command.

• OpenAI API key passthrough
  If OPENAI_API_KEY is available in your environment, tsh passes it into the sandbox container.

Requirements

• Python 3.11 or newer
• Docker Desktop or Docker CLI
• Internet access for cloning Halgorithem and installing packages

Installation

To run tsh, follow these steps:

1. Create a virtual environment:

   python -m venv venv

2. Activate the virtual environment:

   source venv/bin/activate

3. Install the required modules:

   pip install -r Requirements.txt

4. Run tsh:

   python main.py

5. Connect to Halgorithem:

   connect Halgo

You can also launch Halgorithem directly:

python main.py connect Halgo

CLI Usage

Interactive shell:

python main.py

Direct command:

python main.py connect Halgo

Exit the shell:

exit

Notes

• tsh does not install Halgorithem on your machine.
• The Docker sandbox is removed after the session closes.
• Halgorithem dependencies are installed inside the container each time tsh launches the sandbox.