hpcGPT is a single-command CLI that launches an Opencode-based TUI preconfigured for HPC centers, with local MCP servers for Slurm and Illinois Chat docs.

Install

npm i -g hpcgpt

Configure

Create a .env file in your working directory:

cp $(npm root -g)/hpcgpt/example.env .env
# Edit .env with your values

Or set environment variables globally in ~/.hpcgpt/env or manually export them:

export NCSA_LLM_URL="https://<your-hosted-llm>"
export NCSA_OLLAMA_URL="http://<your-ollama>"
export ILLINOIS_CHAT_API_KEY="<your-key>"

The hpcgpt launcher auto-loads .env from the current directory or ~/.hpcgpt/env.

Run

hpcgpt

• The launcher injects this package's opencode.jsonc and an MCP overlay.
• Local MCPs started:
  • slurm-mcp-server (sinfo, squeue, scontrol, accounts)
  • illinois-chat-server (delta-docs, delta-ai-docs)

Commands

• Report: use the report command in the TUI to guide the agent to create a support report.

What’s included

• opencode.jsonc: providers (ncsahosted, ncsaollama), models, MCP wiring, and command.report.
• mcp_servers/*: local MCP servers compiled at install/build time.
• prompts/: prompt content for the support agent.

Development (for maintainers)

Build MCP servers locally (optional):

(cd packages/hpcgpt && bun run build)

Releases and platform packaging are handled automatically by GitHub Actions when you push a tag (vX.Y.Z).

Environment

• NCSA_LLM_URL – Base URL for NCSA Hosted provider
• NCSA_OLLAMA_URL – Base URL for NCSA Ollama provider
• ILLINOIS_CHAT_API_KEY – API key for Illinois Chat docs tools

License

MIT – see LICENSE.