Web PHITS - CLI & AI Agent

Web PHITS can also be used from a terminal, and by AI coding agents (Claude Code, Codex, ...). No local PHITS installation is required — only python3 and a network connection.

Asking an AI agent (Claude Code, Codex, ...)

When asking an AI agent, do not just pass a URL — copy the prompt below and fill in your request. With a URL alone, the agent may not use the bundled PHITS references:

Use Web PHITS as follows.

1. Download https://phits.kek.jp/web/cli/phits-agent-kit.zip and unzip it in the working folder.
2. Read phits-agent-kit/CLAUDE.md first and follow it from then on (AGENTS.md has the same content).
   In particular, do not write PHITS input files from your own knowledge alone —
   consult the bundled agent_reference / knowledge_base.
3. Then perform the following calculation and show the results:
   (your request here, e.g., compute the depth-dose distribution of 150 MeV protons in a water phantom)

Quick start (command line)

Download the runner script once, then run an input file from its folder:

curl -O https://phits.kek.jp/web/cli/phits_web_run.py
python3 phits_web_run.py input.inp

The PHITS console output is shown live, and all result files (phits.out, tally outputs, EPS / auto-converted PDF, ...) are downloaded next to the input file, like a local run. Main options:

• input.inp aux1.dat ... list auxiliary files after the input file (files referenced by infl: etc.)
• --version <id> select the PHITS version (see --list-versions)
• --token <token> use an access token (extends the time limit)
• --compile <file.f90> recompile PHITS with user Fortran sources (usrsors.f90 etc.) before the run

AI Agent Kit

The agent kit bundles the runner script, agent instructions (CLAUDE.md / AGENTS.md), and the PHITS knowledge base (manuals, samples, lectures) for AI reference:

curl -O https://phits.kek.jp/web/cli/phits-agent-kit.zip
unzip phits-agent-kit.zip

Unzip it and start your AI agent (e.g. Claude Code) in the unzipped folder. The agent can then write PHITS input files using the bundled knowledge base, run them on this service, and analyze the downloaded results — on a computer without PHITS.

Limits

• Text files only, up to 1 MB per file; subfolders are not supported.
• The same execution time limit as the browser version applies (a token can extend it).