К основному содержанию
скилл CX Codex

tellurium — скилл для Claude Code: что делает и как установить

Скилл запускает симуляцию кинетических моделей биохимических реакций из SBML или Antimony через Tellurium и экспортирует COMBINE-архивы.

MIT 465 установок ★ 58 036 обновлён 2026-10-19

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add K-Dense-AI/scientific-agent-skills --skill tellurium -a claude-code
Открыть на GitHub

Что делает tellurium

Скилл автоматизирует расчёт кинетических траекторий в биологических сетях через Tellurium и солвер libRoadRunner. Он принимает модели в формате SBML или Antimony, проверяет размерности единиц измерения и запускает детерминированное интегрирование с помощью CVODE. Сценарии с изменением параметров выполняются изолированно: каждый прогон стартует с чистой модели, поэтому концентрации предыдущего шага не исказят следующий расчёт.

Внутри скилл обращается к скрипту scripts/kinetic_experiment.py. По итогам работы формируются CSV-файлы концентраций, модифицированные модели model_<scenario>.xml, файл эксперимента experiment.sedml и архив experiment.omex. Скилл автоматически воспроизводит полученный COMBINE-архив и сверяет результаты с прямым расчётом, сохраняя расхождения и предупреждения в report.json.

Для работы требуется виртуальное окружение Python 3.11 со строго фиксированными версиями tellurium==2.2.13.1, libroadrunner==2.10.0 и сопутствующих библиотек. Скилл отклоняет модели с нульмерными компартментами, правила скоростей (rate rules) и выборки в абсолютных количествах вместо концентраций.

Какие задачи решает

  • рассчитать кинетику концентраций веществ по времени из Antimony или SBML
  • сопоставить поведение системы при изменении кинетических параметров
  • сформировать и перепроверить воспроизводимый COMBINE-архив SED-ML
  • проверить согласованность единиц измерения и реакций в SBML

Примеры запросов агенту

  • Запусти кинетический эксперимент для модели assets/first-order.ant по конфигурации assets/experiment.json.
  • Проверь единицы измерения в SBML-файле model.xml и смоделируй изменение константы скорости реакции.
  • Экспортируй траектории концентраций в SED-ML и собери COMBINE-архив experiment.omex.

Как установить tellurium

1Через Skills CLI (Vercel)

npx skills add K-Dense-AI/scientific-agent-skills --skill tellurium -a claude-code

2Вручную: положить файлы

~/.claude/skills/tellurium/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/tellurium/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о tellurium

Как установить tellurium в Claude Code?

Выполните в терминале команду npx skills add K-Dense-AI/scientific-agent-skills --skill tellurium -a claude-code. Файл появится по пути ~/.claude/skills/tellurium/SKILL.md.

Что делает скилл tellurium?

Он запускает кинетическое моделирование биохимических реакций с помощью Tellurium и libRoadRunner, проверяет размерности SBML и собирает архив эксперимента в формате COMBINE.

Какие зависимости нужны для запуска симуляций?

Требуется Python 3.11 с пакетами tellurium==2.2.13.1, libroadrunner==2.10.0, antimony==3.2.0, python-libsbml==5.21.2, python-libsedml==2.0.34 и python-libcombine==0.2.20. Для работы без графического интерфейса задаётся MPLBACKEND=Agg.

Исходный текст

SKILL.md · MIT
---
name: tellurium
description: Simulates biochemical kinetic models from SBML or Antimony with Tellurium and libRoadRunner, checks model units, compares deterministic parameter perturbations, and exports and replays SBML plus SED-ML COMBINE archives. Use for reaction-network time courses, kinetic parameters, concentration dynamics and reproducible simulation experiments; steady-state constraint-based metabolic flux analysis belongs to cobrapy.
license: MIT
compatibility: Requires Python 3.11 with Tellurium 2.2.13.1, libRoadRunner 2.10.0, Antimony 3.2.0, python-libsbml 5.21.2, python-libsedml 2.0.34 and python-libcombine 0.2.20. Network is needed for installation only. Native wheels were tested on macOS ARM64. No credentials or external services.
metadata:
  version: "1.1"
  skill-author: K-Dense Inc.
  upstream-version: "2.2.13.1"
  last-reviewed: "2026-10-01"
---

# Tellurium kinetic experiments

## When to use

Use this skill for deterministic reaction-network trajectories and independent parameter conditions
from a local model. The helper performs SBML consistency checks, CVODE integration and an actual
COMBINE archive replay. It exports each condition's exact SBML and the SED-ML experiment rather
than handing off an unrecorded notebook state.

## Runtime

```bash
uv venv --python 3.11 kinetic-env
uv pip install --python kinetic-env/bin/python tellurium==2.2.13.1 libroadrunner==2.10.0 \
  antimony==3.2.0 python-libsbml==5.21.2 python-libsedml==2.0.34 python-libcombine==0.2.20
```

The full workflow ran with these packages on macOS ARM64. It constructs SED-ML with libSEDML and
archives with Tellurium/libCombine; PhraSEDML is not required by this helper. Headless runs can set
`MPLBACKEND=Agg`. No plotting window is opened by the helper.

The six pinned releases were rechecked against official PyPI metadata on 2026-10-01. RoadRunner's
documentation site still displays an old version banner; the solver settings below were also
checked against released 2.10.0 source and the installed native runtime.

## Workflow

1. Inspect the supplied model's compartments, species, initial conditions, boundary species,
   reactions, parameter definitions and rules/events. Identify the scientific question and
   distinguish a mechanistic kinetic model from a flux-balance reconstruction. Record the
   source model, version and any literature parameters; do not treat an example model as
   experimentally calibrated.
2. Check units before interpreting a trajectory. SBML reaction rates have amount/time units;
   species may have concentration or amount semantics. In a fixed-volume first-order model,
   `k*A*cell` converts concentration dependence into amount/time. The helper checks SBML
   consistency and retains every warning, including undefined units. Undefined units are
   reported as empty/indeterminable, not silently assumed to mean SI.
3. Select concentration outputs and an experiment in the JSON format described in
   [references/experiments.md](references/experiments.md). Time values use the model's own time
   units. The tested helper outputs concentration for species with `hasOnlySubstanceUnits=false`;
   it rejects amount-only selections to avoid changing their meaning during SED-ML replay.
   Zero-dimensional compartments and rate-rule models are also rejected; the latter need a separate
   tolerance workflow because RoadRunner 2.10.0 can order scalar tolerances differently from states.
4. Run baseline and desired constant-global-parameter changes. Every scenario starts from a
   fresh SBML model, so previous final concentrations cannot leak into the next condition.
   Changes to species initial values, compartment volume, assignment rules or time-varying
   inputs require explicit model changes and corresponding tests; they are not parameter
   mutations hidden in this helper.
5. Examine finite outputs, signs, relevant conservation relations and timescales. Check solver
   sensitivity by repeating at stricter tolerances when the scientific interpretation depends
   on small differences. A smooth curve or zero archive-replay error does not establish model
   validity or parameter identifiability. Never clip negative concentrations to hide solver
   or model problems.
6. Review the COMBINE replay comparison, model warnings and units in `report.json`. The helper
   replays the archive it generated and compares every selected value against the direct
   trajectories. Deliver the archive, report, source model, experiment config and CSV curves.

## Run the executable reference

[assets/first-order.ant](assets/first-order.ant) defines the closed reaction A → B in a constant
1-L compartment, initially A=1 and B=0 mol/L, with k=0.2 per second.
[assets/experiment.json](assets/experiment.json) runs baseline and k=0.4 per second from 0 to 10 s.
From the skill directory, point the interpreter to the environment created above:

```bash
MPLBACKEND=Agg kinetic-env/bin/python scripts/kinetic_experiment.py \
  --model assets/first-order.ant --format antimony --experiment assets/experiment.json \
  --output kinetic-reference

# The SBML branch was also exercised; replace these filenames with actual user inputs.
MPLBACKEND=Agg kinetic-env/bin/python scripts/kinetic_experiment.py \
  --model model.xml --format sbml --experiment experiment.json --output kinetic-analysis
```

Output directories must be new. The reference was executed, including Antimony-to-SBML conversion,
libSBML checks, both direct integrations, SED-ML creation and COMBINE replay. Both conditions matched
the analytical `A(t)=exp(-k*t)`, `B(t)=1-A(t)` within 2e-8 absolute/relative tolerance; A+B was
conserved within 1e-10, and archive replay matched direct output exactly on the tested stack.
Additional checks use a 5-L compartment and an initial amount of 10 mol (2 mol/L), resolve every
SED-ML species XPath against its actual SBML file, and verify the solver tolerance scaling.
That verifies this controlled example; arbitrary SBML packages, events, delays or stochastic models
are not covered by those tests.

## Artifacts

| File | Contents |
| --- | --- |
| `baseline.csv`, other scenario CSVs | Time and selected concentrations, with bracketed species headers |
| `model_<scenario>.xml` | Exact independent SBML condition used by both execution routes |
| `experiment.sedml` | Uniform time course, CVODE/tolerances, models, tasks and output selections |
| `experiment.omex` | Those SBML files plus the master SED-ML and archive manifest |
| `report.json` | Versions, input/archive checksums, parameters, units, validation findings, initial state tolerance vectors, minimum concentrations and replay differences |

The libSEDML findings in the report are **parse diagnostics**. Successful execution and equality
provide additional evidence that this generated uniform-course experiment works in Tellurium;
they do not certify every SED-ML feature or every simulator's compatibility.

In RoadRunner 2.10.0, the JSON `absolute_tolerance` value is a **scalar adjustment factor** for
state/amount tolerances, not a uniform concentration error bound. The archive records that meaning
as `KISAO:0000571`; inspect `initial_state_absolute_tolerances` and the detailed explanation in
[references/experiments.md](references/experiments.md). Declared SBML XPath namespaces and explicit
stiff/uniform-output settings prevent successful Tellurium replay from hiding missing archive context.

## Primary references

- [Tellurium model loading and export methods](https://tellurium.readthedocs.io/en/latest/tellurium_methods.html)
- [Antimony unit and reaction semantics](https://tellurium.readthedocs.io/en/latest/antimony.html)
- [Tellurium SED-ML implementation](https://tellurium.readthedocs.io/en/latest/_modules/tellurium/sedml/tesedml.html)
- [SED-ML Level 1 Version 3 specification](https://sed-ml.org/documents/sed-ml-L1V3.pdf)
- [RoadRunner 2.10.0 CVODE implementation](https://github.com/sys-bio/roadrunner/blob/v2.10.0/source/CVODEIntegrator.cpp)
- [KiSAO algorithm and parameter definitions](https://github.com/SED-ML/KiSAO/blob/master/kisao.owl)

© K-Dense-AI · MIT · K-Dense-AI/scientific-agent-skills

Похожие скиллы

Все скиллы по теме «Наука и исследования» →
Axiomize Furox-Art Axiomize помогает собирать версионные научные модели с единицами измерения, проверять их и экспортировать в SBML, CellML и Modelica. CX Codex +1 ★ 9звёзд репо paper-to-social franklee16 Скилл paper-to-social перерабатывает научные статьи и препринты в посты для LinkedIn, X, Xiaohongshu и Substack с учётом формата каждой площадки. CX Codex +1 ★ 240звёзд репо yomitoki franklee16 Скилл yomitoki превращает научные статьи и препринты в подробные интерактивные HTML-конспекты с формулами, разбором методов и кодом. CX Codex +1 ★ 240звёзд репо benchmark-and-mms-planner HeshamFS Скилл benchmark-and-mms-planner помогает составить план верификации и валидации расчётных кодов по методу искусственных решений (MMS), каноническим бенчмаркам и сеткам. CX Codex +1 ★ 95звёзд репо simulation-validator HeshamFS Скилл simulation-validator для Claude Code проверяет численные симуляции до, во время и после запуска. Разбирает сбои. CX Codex +1 ★ 95звёзд репо terrain-hydrology Muhammed Enes Duran Скилл terrain-hydrology для Claude Code, Codex, Cursor, Copilot, Gemini CLI и OpenCode. Разбирается с рельефом и водосборами по данным высот: от выбора DEM до расчёта уклонов, водотоков и зон видимости. CX Codex +1 ★ 48звёзд репо

Из того же набора176

Весь набор →
flowkit Скилл flowkit для анализа проточной цитометрии в Python: рассчитывает гейты, применяет компенсацию флуоресценции и читает воркспейсы FlowJo 10. CX Codex +1 467установок pybamm Скилл запускает модели литий-ионных батарей в PyBaMM, сравнивает расчёт с измерениями и проверяет численную погрешность. CX Codex +1 467установок cantera Рассчитывает гомогенные реакторы в Cantera и определяет задержку воспламенения с проверкой баланса энергии. Моделирует кинетику горения идеального газа. CX Codex +1 465установок nmrglue Скилл nmrglue для Claude Code обрабатывает одномерные NMR-сигналы в фазированные спектры, пики и интегралы регионов. Калибрует и воспроизводимо обрабатывает сырые FID на Python 3.12+, NumPy и SciPy. CX Codex +1 465установок mageck Скилл mageck считает риды из FASTQ и матрицы гайдов, проверяет библиотеки, запускает QC реплик и выдаёт рейтинг генов с FDR для пулированных CRISPR-скринов. CX Codex +1 465установок qiime2-amplicon Скилл qiime2-amplicon для Claude Code обрабатывает парные 16S-риды в QIIME 2, создавая ASV-таблицы и таксономию с историей преобразований. CX Codex +1 465установок cellprofiler Запускает CellProfiler для подсчёта ядер и измерения флуоресценции. Анализирует 2D TIFF-снимки. CX Codex +1 464установок pycalphad Скилл pycalphad рассчитывает термодинамические фазовые равновесия сплавов по TDB-базам данных. Помогает моделировать составы и доли фаз при заданных температурах и давлении. CX Codex +1 463установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой