prmcp

One endpoint for a prain-served model: MCP tools picked by model name (gemma4+terminal,web). The proxy itself is not written yet; this repo holds the stack around it so far.

The prain stack: prain up

scripts/prain is a front door for the prain command. up, down, restart, status and logs drive the stack's OpenRC user services. Every other subcommand (serve, web, tui, check, ...) goes to prain's own CLI in PRAIN_ROOT/.venv, with scripts/env.sh sourced first, so you no longer need to source it yourself. (In a shell where you did, the venv's prain comes first on PATH and prain up is unknown there.) prain --help shows prain's own help with the stack commands merged into its command list.

prain up [NAME...]        start the services (all by default), waiting until each is ready
prain down [NAME...]      stop them, in reverse order
prain restart [NAME...]
prain status [NAME...]
prain logs [NAME...]      tail -F their logs (~/.local/state/prain/NAME.log)

Services live in ~/.config/prain/prain.conf (PRAIN_CONF overrides): PRAIN_SERVICES lists them. Per service:

• cmd_NAME: the command, run in PRAIN_ROOT with env.sh sourced.
• ready_NAME: a URL prain up waits for.
• requires_NAME: services that must already be up. If one isn't, NAME refuses to start with a message (prain: web needs vllm, which is not running ... Start it first: prain up vllm). It never starts them itself.

See scripts/prain.conf.example.

One OpenRC script, openrc/init.d/prain, serves them all through links named prain.NAME. OpenRC settings go in ~/.config/rc/conf.d/prain.NAME:

• rc_after="prain.vllm": start order when both are in a runlevel. It doesn't start vLLM.
• respawn_max (3) and respawn_period (600 s; 1800 for vLLM): supervise-daemon restarts a crashed service, and gives up after more than respawn_max crashes within respawn_period. Crashes further apart are restarted forever.
• respawn_delay (5 s).

Install

ln -s "$PWD/scripts/prain" ~/.local/bin/prain
mkdir -p ~/.config/prain ~/.config/rc/init.d ~/.config/rc/conf.d
cp scripts/prain.conf.example ~/.config/prain/prain.conf
ln -s "$PWD/openrc/init.d/prain" ~/.config/rc/init.d/prain
for n in vllm web; do ln -s prain ~/.config/rc/init.d/prain.$n; done
cp openrc/conf.d/prain.* ~/.config/rc/conf.d/
# optional, start both with the session (web waits for vLLM through rc_after):
rc-update --user add prain.vllm default && rc-update --user add prain.web default

A new service is a cmd_NAME line, its name in PRAIN_SERVICES and one more prain.NAME link.

Test

bash scripts/test_prain.sh