metatron/README.md

METATRON — lightweight Ollama terminal harness

A minimal terminal harness for talking to Ollama (hosted on nightmare 10.30.20.29:11434) with full system access. Type metatron to launch.

Flow

1. Model selection — fetches the live model list from nightmare, numbered menu.
2. Chat — streaming REPL against the selected model.
3. System access — two ways:
   • !command — run a shell command directly (e.g. !dir, !whoami).
   • The model calls run_command natively (function calling) to execute commands itself.

Requirements

• Python 3.11 (stdlib only — urllib, subprocess, json). No pip deps.
• Network reach to 10.30.20.29:11434.

Install (Commando VM)

mkdir C:\Tools\metatron
copy metatron.py metatron.bat C:\Tools\metatron\
setx PATH "%PATH%;C:\Tools\metatron"

Then metatron from any shell.

Hardcoded

• Ollama URL: http://10.30.20.29:11434
• System prompt + run_command tool definition
• Only the model list is dynamic (fetched from /api/tags).

Controls

Input	Action
exit / quit	leave
!<command>	run a shell command directly