Files
metatron/README.md

43 lines
1.5 KiB
Markdown

# 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 and internet search. 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** — `!command` runs a shell command directly, and the model can also
call `run_command` natively (function calling).
4. **Search** — `?query` searches the internet (SearXNG), and the model can call
`web_search` natively.
## Requirements
- Python 3.11 (stdlib only — `urllib`, `subprocess`, `json`). No pip deps.
- Network reach to `10.30.20.29:11434` and `10.30.20.35:6969`.
## 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.
## Controls
| Input | Action |
|-------|--------|
| `exit` / `quit` | leave |
| `!<command>` | run a shell command directly |
| `?<query>` | search the internet (SearXNG) directly |
## Hardcoded
- Ollama URL: `http://10.30.20.29:11434`
- SearXNG URL: `http://10.30.20.35:6969` (self-hosted meta-search, CT 516)
- System prompt + `run_command` / `web_search` tool definitions
- Only the model list is dynamic (fetched from `/api/tags`).
## Search notes
- `?<query>` is the guaranteed path (no LLM needed).
- Native `web_search` tool-calling can degenerate on nightmare `.29`'s qwen3.8fast —
the `?` escape always works.