Starsim-AI

This repository contains AI agents, skills, and tools for working with Starsim, the agent-based disease modeling framework.

Plugins

This repo contains three Claude Code plugins, installable via the built-in marketplace:

• project-improver (plugins/project-improver/) — Check a project against engineering quality guidelines, and make improvements
• starsim-ai (plugins/starsim/) — Starsim and Sciris MCP tools and modeling skills
• disease-modeling (plugins/disease_modeling/) — General disease modeling skills and tools

Claude Code

To install, add this repo as a marketplace inside Claude Code:

Method	Instructions
CLI	Run /plugin marketplace add https://github.com/starsimhub/starsim_ai
VS Code extension	/plugin → Manage plugins → Marketplaces → Add from https://github.com/starsimhub/starsim_ai

Then install either or both plugins from the Discover tab (/plugin).

Note: if you use Sciris heavily, you may also want to use its plugin.

Outside of Claude Code

Although these plugins were built for Claude Code, they will work with any LLM via OpenSkills.

Quick usage example

Once the starsim-ai plugin is installed, just ask Claude to build a model. The plugin's skills activate automatically based on context:

You: "Build a simple SIR model with 10,000 agents, beta=0.1, and plot the results"

Claude: [activates starsim-dev-intro and starsim-dev-diseases skills, then writes and runs the model]

You can also invoke skills directly with slash commands (e.g., /starsim-dev).

Skills

Starsim

The Starsim-AI plugin includes the following skills:

Skill	Purpose
starsim-dev	Router — dispatches to topic-specific skills
starsim-dev-intro	Getting started with Starsim basics and architecture
starsim-dev-sim	Configuring the Sim object, People, and parameters
starsim-dev-diseases	Creating and customizing disease models (SIR, SIS, SEIR, etc.)
starsim-dev-networks	Contact networks and mixing pools
starsim-dev-demographics	Births, deaths, pregnancy, and population dynamics
starsim-dev-interventions	Vaccination, screening, treatment, and custom interventions
starsim-dev-connectors	Disease-disease interactions in multi-disease models
starsim-dev-analyzers	Custom result collection and analysis
starsim-dev-distributions	Probability distributions and sampling
starsim-dev-calibration	Model calibration with Optuna and Bayesian methods
starsim-dev-run	Running multiple sims, scenarios, and parallelization
starsim-dev-time	Dates, durations, rates, and time conversions
starsim-dev-indexing	Arrays, UIDs, boolean states, and agent indexing
starsim-dev-random	Common random numbers and reproducibility
starsim-dev-nonstandard	Compartmental (ODE) models and general-purpose ABMs
starsim-dev-profiling	Performance profiling and debugging
starsim-style-python	Python code style conventions
starsim-style-docs	Documentation style (docstrings, READMEs, tutorials)
starsim-style-philosophy	Starsim design philosophy
starsim-style-tests	Testing conventions
sciris-utilities	Sciris utilities (file I/O, parallelization, data structures)
stisim-modeling	STIsim — STI disease modeling (HIV, syphilis, etc.)

Disease modeling

The Disease-Modeling plugin was trained on Harvard's Introduction to Infectious Disease Modeling course. It includes the following skills:

Skill	Purpose
basic_epi_modeling	Foundational concepts — disease burden, transmission routes, compartmental model selection
sir-models	SIR compartmental models, R0, epidemic curves, ODE solvers
sir-elaborations	SEIR, MSIR, SIRS, age structure, contact matrices, multi-strain dynamics
vaccination	Vaccination modeling — herd immunity, efficacy types, waning immunity, pulse/ring strategies
vectors	Vector-borne and waterborne disease models (Ross-MacDonald, SIWR, multi-strain)
parameter-estimation	Model fitting — least squares, MLE, Bayesian inference, calibration
surveillance	Surveillance data, nowcasting, forecasting, genomic epidemiology

MCP servers

Automatic MCP servers

Starsim is available on Context7:

https://context7.com/starsimhub/starsim

It is also available on GitMCP:

https://gitmcp.io/starsimhub/starsim

Manual MCP usage

Warning

Manual MCP servers may not be up to date; GitMCP or Context7 is recommended.

Built on mcp_pack.

Copy the following into settings.json, or into mcp.json for VS Code, Cursor, Claude, etc.:

    "mcp": {
        "servers": {
            "starsim": {
                "type": "sse",
                "url": "http://mcp.starsim.org:8001"
            },
            "sciris": {
                "type": "sse",
                "url": "http://mcp.starsim.org:8002"
            }
        }
    }

These agents should now be available to your IDE.

To use these tools in Claude Code, you can also use the following commands:

claude mcp add --transport sse starsim http://mcp.starsim.org:8001/sse
claude mcp add --transport sse sciris http://mcp.starsim.org:8002/sse

Repo structure

• deploy_mcp_pack: Scripts for manually deploying the Starsim MCP server
• internal: Scripts used for creating the AI tools (not for the user)
• plugins: Claude Code skills and plugins

Links

• Report an issue
• Starsim documentation
• Starsim on GitHub