a bot to do misc things for the Polyfrost server
- clone it
- copy
config.example.jsontoconfig.jsonand fill it out pnpm install --frozen-lockfilepnpm start
/spark analyze <link> hands a spark profile to one Claude agent running the skills/spark-analyzer skill on the bot's
host. Before the agent starts, the bot scans the jars of the suspect mods (the exact versions from Modrinth) for
bail-out gates, such as a mod turning an optimization off because another mod is loaded. When a mod has no jar on
Modrinth, it scans the mod's source on GitHub instead. The agent can ask a smaller model to read source files for it.
The full analysis, including a dev handoff when a mod's code could fix the problem, is posted in the sparkAnalysis
channel. The support team member who ran the command also gets a private summary with a link to it.
/spark compare <baseline> <link> does the same for two profiles, such as without and with a mod, and reports what
changed between them. The Scan Spark Log message context menu runs analyze on the link in a message.
Each analysis has a spend target (sparkAnalysis.costTarget), where the agent is told to wrap up, and a hard cap
(sparkAnalysis.costCap).
- install Python 3. Set
sparkAnalysis.pythonif it isn'tpython3on yourPATH - set
sparkAnalysis.enabledtotrueand fill insparkAnalysis.anthropicApiKey - optionally set
sparkAnalysis.githubTokenso the agent can search mod source code and scan mods that aren't on Modrinth
- Docker >= 20
- Older versions may also work, but have not been tested.
-
clone it
-
copy
config.example.jsontoconfig.jsonand fill it out -
Run the container:
The container runs as the node user (UID/GID 1000). Create the folders before starting the container, otherwise
Docker creates them owned by root:
mkdir -p data
sudo chown -R 1000:1000 config.json data docker container run --restart=unless-stopped -itd -v ./config.json:/app/config.json -v ./data/:/app/data/ --name polyhelper ghcr.io/kathund/polyhelper:latestNote that the path of the configuration source file must either be relative (with the ./) or absolute.