IOWARP / DOCUMENTATION
Documentation lives with the code.
IOWarp is the team at the Gnosis Research Center that builds CLIO, the open-source stack that connects AI agents to scientific data and systems. It matters because a team can start with the product that fits its work and add the rest as it needs them. This page points to the right guide and gives the first command for each product, with release-tag sources for compatibility.
A guide for every product.
Install the scientific data workspace, connect a model, work with files and conversations, and add marketplace plugins and MCP tools.
Open clio.iowarp.ai ↗CLIO CoderGuides for the meta-harness: installation, model connections, repository context, checks, worker fleets, research campaigns, and the model arena.
Open coder.iowarp.ai ↗CLIO KitChoose scientific MCP servers and skills, install workflow plugins into a supported client, and check component dependencies and client-specific limits.
Open toolkit.iowarp.ai ↗CLIO CoreInstall the context runtime, use its Python APIs, compose storage tiers and data operators, mount the filesystem, and explore the runtime dashboard.
Open core.iowarp.ai ↗Get started from the command line.
Choose the product for your task, then follow its guide for platform requirements and model setup. These commands use the public release paths. The current Kit release installs a launcher plus the components you select; Agent’s installer keeps its own tested Kit pin.
- CLIO Agent
curl -fsSL https:/Guide for CLIO Agent/ clio.iowarp.ai/ install.sh | bash - CLIO Coder
curl -fsSL https:/Guide for CLIO Coder/ coder.iowarp.ai/ install.sh | sh - CLIO Kit
uv tool install clio-kitGuide for CLIO Kit - CLIO Core
pip install iowarp-coreGuide for CLIO Core - CLIO Relay
uv tool install --python 3.12 --no-config clio-relayREADME for CLIO Relay - CLIO Schemas
pip install clio-schemasREADME for CLIO Schemas
The context runtime, in depth.
The Core portal covers installation, Python APIs, storage composition, and data operators. The stable release notes and tagged runtime configuration establish released behavior; check the published files for wheel compatibility. Agent retains its own tested Core dependency. The platform page explains the runtime’s role.
- 01
Install CLIO Core ↗
Published wheels, the conda channel, native packages, and source-build prerequisites. Check PyPI files for current wheel compatibility.
- 02
Components and modules ↗
Transport primitives, the modular runtime, and the assimilation, transfer, and exploration engines in the stable source.
- 03
Python API ↗
Bundle, query, and retrieve context with clio_cee, or work with tags, blobs, and search through clio_cte_core_ext.
- 04
Runtime configuration ↗
Compose local storage tiers and the filesystem chain. The tagged configuration documents defaults for the stable runtime.
Concepts in short.
Short explainers on context management for AI agents, scientific AI agents, MCP servers for science, HPC I/O, and agentic workflows. Each defines the topic, explains how IOWarp approaches it, and links to the papers, software, and applications that ground it.
Context management is the work of deciding what an AI agent sees, when, and with what authority: which data, which tool results, which prior decisions, and which limits.
Read the explainer →T2Scientific AI agentsA scientific agent is a language-model-driven program that carries out steps of a research workflow by calling tools: reading datasets, submitting jobs, running analyses, and producing figures.
Read the explainer →T3MCP servers for scientific computingThe Model Context Protocol is an open standard through which AI applications call external tools and read external resources.
Read the explainer →T4HPC I/O and storage hierarchiesHPC I/O research studies how applications read and write data on supercomputers: through memory, burst buffers, node-local flash, parallel file systems, and archives.
Read the explainer →T5Data movement for AI-infused workflowsScientific data rarely starts where it will be used.
Read the explainer →T6Scientific workflows and reproducible deploymentA scientific workflow chains simulation, analysis, AI, and visualization steps across machines.
Read the explainer →T7Evidence-based autonomous researchAutonomous research systems propose changes and test them.
Read the explainer →Common questions.
Questions that cross component boundaries. Version-specific answers live in each component’s documentation.
What is the difference between IOWarp and CLIO?
IOWarp is the team at the Gnosis Research Center that builds CLIO. CLIO, the Context Layer for I/O, is the open platform it builds: the agentic frameworks CLIO Agent and CLIO Coder, the CLIO Kit tools they share, the CLIO Core context runtime, and the GPU, storage, application, and research components around them. It matters because organizations can run AI agents against scientific data and keep a record their people can check.
Which component should I install first?
Choose the task first. Install CLIO Agent to work with scientific data, or CLIO Coder to work on scientific software; they are different products for different audiences. Install CLIO Kit to give any MCP-compatible agent scientific tools, and CLIO Core for the context runtime and its APIs. Each installs on its own and has its own prerequisites.
How do I install CLIO Core?
Install the standalone runtime with pip install iowarp-core. Check the PyPI files for current CPython versions, operating systems, and architectures. GPU runtimes come as separate CUDA, ROCm, and SYCL wheels or source builds. MPI and some format adapters need a source build. Linux wheels need libfuse3 to mount, Windows needs WinFsp, and macOS mounting requires a source build with macFUSE. Keep Agent’s tested Core dependency when installing Agent. Published wheel compatibility on PyPI ↗ Mount on macOS ↗
How do I install CLIO Agent on my system?
For the Desktop app bundled with its agent, run curl -fsSL https://clio.iowarp.ai/desktop.sh | bash on Apple Silicon macOS or Linux, or irm https://clio.iowarp.ai/desktop.ps1 | iex in PowerShell on Windows, or download a package at clio.iowarp.ai. For the local service and web interface only, run curl -fsSL https://clio.iowarp.ai/install.sh | bash on Linux or macOS, or irm https://clio.iowarp.ai/install.ps1 | iex on Windows, then open it with clio web or start it headless with clio start. The installer downloads the prebuilt release runtime and provisions Agent’s tested Core and Kit dependencies. Agent installation guide ↗ Release installation reference ↗ Connect a model ↗
How do I install CLIO Coder on my system?
The shell installer needs no root and supplies its own Node.js runtime on Linux and macOS. PowerShell and CMD installers are available for Windows, where native interactive use remains best effort. An npm install uses your own supported Node.js runtime. Connect a model that supports tool calling, then run clio-coder doctor to check the installation and connections. Coder documentation and installation ↗
How do I install the scientific MCP servers?
Install the standalone CLIO Kit launcher with uv tool install clio-kit. Run clio-kit mcp-servers to list its servers, then clio-kit mcp-server hdf5 to fetch and start the HDF5 component. Components download on demand, and server dependencies stay isolated and locked. Follow the client guide to register a server or install a workflow plugin. Selective installation ↗ Client setup and component support ↗
Should I upgrade the Core or Kit installed by CLIO Agent?
Agent keeps Core in its tested compatible release family and pins Kit for its marketplace plugins. Keep that combination when installing Agent. Standalone Core and Kit have separate release and upgrade paths; a newer standalone package does not establish Agent compatibility. Agent’s tested dependency declarations ↗ Agent installer and its Kit pin ↗ Standalone Kit installation ↗
Which scientific formats are supported?
It depends on the component. CLIO Kit has tools for formats such as HDF5, Parquet, ADIOS2, SAC, and geospatial data. CLIO Core has its own assimilation adapters, including HDF5 in source builds. Check the specific server or adapter before relying on a format in a workflow.
Is there a Python API?
Yes. CLIO Core ships clio_cee for bundling, querying, retrieving, and destroying contexts, and clio_cte_core_ext for tags, blobs, and search. Its Python guide explains runtime attachment and indexing requirements. Core Python API ↗
What can I add to CLIO Coder?
Library packs and content plugins provide reusable instructions and procedures. Sandboxed extensions load after approval of their declared capabilities, and playbooks describe fleet contracts. A semantic context index is optional; background indexing is off by default, and scanned PDF recognition and raw video embedding are unsupported. The research and arena commands use the checks you declare in the project. The desktop app remains alpha. Research and arena guide ↗ Released behavior and limits ↗
Is every CLIO component available now?
The current flagships, scientific context runtime, and supporting tools are open source, and IOWarp will launch the full stack at SC26 in Chicago. GPU and operating-system backends have build and hardware prerequisites. Archived BaM and GPU–NVMe bridge prototypes remain in older tagged source and are absent from the current Core release. Current Core release ↗ Archived prototypes ↗
Where should I report a problem or propose an integration?
Open an issue in the repository of the component you used, with the version, environment, input format, expected and observed results, and a small reproducible example if you can. Zulip is open for discussion.
Next step
Not sure
where to start?
CLIO Agent works with scientific data and CLIO Coder works on scientific software. Both can use scientific tools from CLIO Kit.
