Metadata-Version: 2.5
Name: clio-agent
Version: 0.9.6
Summary: CLIO Agent — Autonomous AI agent framework for scientific data management. Part of the IOWarp platform.
Project-URL: Homepage, https://github.com/iowarp/clio-agent
Project-URL: Documentation, https://iowarp.github.io/clio-agent/
Project-URL: Repository, https://github.com/iowarp/clio-agent
Project-URL: Issues, https://github.com/iowarp/clio-agent/issues
Author-email: Jaime Cernuda <jcernudagarcia@illinoistech.edu>, Antonis Kougkas <a.kougkas@gmail.com>, Gnosis Research Center <gra@iit.edu>
Maintainer-email: Jaime Cernuda <jcernudagarcia@illinoistech.edu>, Antonis Kougkas <a.kougkas@gmail.com>
License: BSD-3-Clause
License-File: LICENSE
Keywords: a2a-protocol,adios,agent-registry,arc-memory,autonomous-agent,clio,clio-agent,data-io-optimization,data-science,fastmcp,hdf5,hpc,iowarp,llm-agents,mcp,multi-agent,optimizer-layer,parquet,react-pattern,scientific-computing,self-improving,slurm
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: System :: Distributed Computing
Requires-Python: >=3.12
Requires-Dist: clio-kit==2.11.1
Requires-Dist: clio-schemas==0.7.0b1
Requires-Dist: dspy==3.4.0
Requires-Dist: fastapi>=0.140
Requires-Dist: fastmcp-tasks==4.1.2
Requires-Dist: fastmcp==4.1.2
Requires-Dist: filelock>=3.12.0
Requires-Dist: fsspec>=2025.9.0
Requires-Dist: gdrive-fsspec>=0.4.1
Requires-Dist: globus-sdk>=4.6.0
Requires-Dist: globusfs==0.2.1
Requires-Dist: h5grove>=4.0.0
Requires-Dist: h5py>=3.10.0
Requires-Dist: httpx2>=2.9.1
Requires-Dist: httpx>=0.27.0
Requires-Dist: iowarp-core~=2.4.0
Requires-Dist: jinja2<4,>=3.1.6
Requires-Dist: jsonschema>=4.23
Requires-Dist: litellm==1.102.2
Requires-Dist: lru-dict>=1.3.0
Requires-Dist: markdown-it-py<5,>=3.0
Requires-Dist: matplotlib>=3.8.0
Requires-Dist: mcp==2.2.0
Requires-Dist: msgspec>=0.22.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: odfpy<2,>=1.4.1
Requires-Dist: openai-codex-cli-bin>=0.167.0
Requires-Dist: openpyxl<4,>=3.1.5
Requires-Dist: packaging>=24.0
Requires-Dist: paramiko>=3.5.0
Requires-Dist: pillow>=10
Requires-Dist: platformdirs>=4.0.0
Requires-Dist: playwright==1.64.1
Requires-Dist: prompt-toolkit>=3.0.0
Requires-Dist: psutil>=5.9.0
Requires-Dist: pyarrow>=14.0.0
Requires-Dist: pydantic<2.14,>=2.12
Requires-Dist: pydocket==0.26.2
Requires-Dist: pypdf<7,>=5.1.0
Requires-Dist: python-docx<2,>=1.1.2
Requires-Dist: python-pptx<2,>=1.0.2
Requires-Dist: pyyaml<7,>=6.0.3
Requires-Dist: rasterio>=1.4
Requires-Dist: requests>=2.31.0
Requires-Dist: rich>=14.2.0
Requires-Dist: sortedcontainers>=2.4.0
Requires-Dist: sse-starlette>=1.6.0
Requires-Dist: truststore==0.10.4
Requires-Dist: tzdata>=2024.1
Requires-Dist: tzlocal>=5.2
Requires-Dist: uv<1,>=0.13.4
Requires-Dist: uvicorn>=0.54.0
Requires-Dist: websockets>=13.0
Requires-Dist: xarray>=2024.10
Requires-Dist: zarr>=3
Requires-Dist: zstandard==0.25.0
Provides-Extra: adios
Requires-Dist: adios2>=2.10.0; (platform_system != 'Windows') and extra == 'adios'
Provides-Extra: all
Requires-Dist: adios2>=2.10.0; (platform_system != 'Windows') and extra == 'all'
Requires-Dist: claude-agent-sdk>=0.2.159; extra == 'all'
Requires-Dist: ddgs>=6.0; extra == 'all'
Requires-Dist: flowcept[mongo,redis]<2,>=1.0.3; extra == 'all'
Requires-Dist: github-copilot-sdk>=1.0.29; extra == 'all'
Requires-Dist: globus-sdk>=3.0.0; extra == 'all'
Requires-Dist: hypothesis>=6; extra == 'all'
Requires-Dist: mypy>=1.7.0; extra == 'all'
Requires-Dist: numpy>=1.24.0; extra == 'all'
Requires-Dist: pandas<3,>=2.0.0; extra == 'all'
Requires-Dist: pandas>=2.0.0; extra == 'all'
Requires-Dist: pydantic-settings>=2.6; extra == 'all'
Requires-Dist: pytest-asyncio>=0.24.0; extra == 'all'
Requires-Dist: pytest-cov>=4.1.0; extra == 'all'
Requires-Dist: pytest-repeat>=0.9.3; extra == 'all'
Requires-Dist: pytest-timeout>=2.3.1; extra == 'all'
Requires-Dist: pytest-xdist>=3.5.0; extra == 'all'
Requires-Dist: pytest>=9.0.3; extra == 'all'
Requires-Dist: python-dotenv>=1.0; extra == 'all'
Requires-Dist: readability-lxml>=0.8; extra == 'all'
Requires-Dist: ruff>=0.1.0; extra == 'all'
Requires-Dist: scipy>=1.11.0; extra == 'all'
Requires-Dist: trafilatura>=1.12; extra == 'all'
Provides-Extra: argonne
Requires-Dist: globus-sdk>=3.0.0; extra == 'argonne'
Provides-Extra: claude-code
Requires-Dist: claude-agent-sdk>=0.2.159; extra == 'claude-code'
Provides-Extra: copilot
Requires-Dist: github-copilot-sdk>=1.0.29; extra == 'copilot'
Provides-Extra: desktop
Requires-Dist: ddgs>=6.0; extra == 'desktop'
Requires-Dist: pydantic-settings>=2.6; extra == 'desktop'
Requires-Dist: python-dotenv>=1.0; extra == 'desktop'
Requires-Dist: readability-lxml>=0.8; extra == 'desktop'
Requires-Dist: trafilatura>=1.12; extra == 'desktop'
Provides-Extra: dev
Requires-Dist: hypothesis>=6; extra == 'dev'
Requires-Dist: mypy>=1.7.0; extra == 'dev'
Requires-Dist: pandas>=2.0.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
Requires-Dist: pytest-repeat>=0.9.3; extra == 'dev'
Requires-Dist: pytest-timeout>=2.3.1; extra == 'dev'
Requires-Dist: pytest-xdist>=3.5.0; extra == 'dev'
Requires-Dist: pytest>=9.0.3; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Provides-Extra: flowcept
Requires-Dist: flowcept[mongo,redis]<2,>=1.0.3; extra == 'flowcept'
Requires-Dist: pandas<3,>=2.0.0; extra == 'flowcept'
Provides-Extra: optimizers
Requires-Dist: numpy>=1.24.0; extra == 'optimizers'
Requires-Dist: scipy>=1.11.0; extra == 'optimizers'
Description-Content-Type: text/markdown

<p align="center">
  <img src="branding/clio/wordmark.svg" alt="CLIO — an AI workspace for scientific data" width="320">
</p>

<p align="center">
  <a href="https://clio.iowarp.ai"><strong>Website & downloads</strong></a> ·
  <a href="https://clio.iowarp.ai/docs/">User guide</a> ·
  <a href="https://github.com/iowarp/clio-agent/releases/latest">Latest release</a>
</p>

CLIO is an **AI workspace for scientific data**, part of [IOWarp](https://iowarp.org).
Work with files, analysis, visualizations and documents in **Desktop or your browser**.
Connect a local model, a provider account, or a model service from your lab.

- Organize work in workspaces and conversations, with persistent ARC memory.
- Extend CLIO with marketplace plugins, agents, tools and flows.
- Inspect HDF5, Parquet and CSV data through MCP tools.
- Run tools where your data lives, locally or on a remote computer.

## Get CLIO

Start at **[clio.iowarp.ai](https://clio.iowarp.ai/#download)** for the Desktop
installer for Windows, Apple Silicon macOS, or Linux. Choose a **bundled** installer:
it includes the CLIO service and its runtimes. Setup prepares the tools and Office
renderer; then open **CLIO Desktop** and choose a model.

You can also install Desktop from a terminal:

**Linux / macOS**

```sh
curl -fsSL https://clio.iowarp.ai/desktop.sh | bash
```

**Windows (PowerShell)**

```powershell
irm https://clio.iowarp.ai/desktop.ps1 | iex
```

See the **[installation guide](https://clio.iowarp.ai/docs/install/)** for supported
systems, selecting a release, remote deployment and first-launch steps.
An assistant such as Claude Code can follow the **[installation instructions for
AI assistants](https://clio.iowarp.ai/install.md)**.

### Web and servers

For a browser deployment, use the published Web image. From a clone of this repository:

```sh
docker compose up clio-web
# Open http://localhost:8080
```

For a local service with Web, run the install script **without** `--desktop`
(`-Desktop` on Windows), then run `clio` or `clio web`. Use `clio start` for a
headless service, and `clio status`, `clio stop` and `clio logs` to manage it.
The script provisions Python and uv; a release install needs no Git or Go.

**The legacy TUI is frozen and unsupported as of 0.9.5.1.** It is not a valid way
to install, run or verify current CLIO. New releases do not ship its binaries or
Docker image; `clio attach` reports this status instead of running an old binary.
Its [source and integration notes](docs/tui/README.md) remain for a future upgrade.

### Contributors and backend-only installations

`--source` installs `main`; `--dev --source` installs `develop`; add `--ref <ref>`
to select a branch, tag or commit. On Windows use `-Source`, `-Dev` and `-Ref`.
Source mode needs Git and installs the service without building a frontend. See
[contributor setup](docs/CONTRIBUTOR_QUICKSTART.md) for Web/Desktop development.

CLIO 0.9.6 uses standard Python 3.14 with the GIL enabled. For a persistent
backend-only installation with the verified SDK roots:

```sh
uv tool install --python 3.14 --with dspy==3.4.0 --with fastmcp==4.1.2 --with fastmcp-tasks==4.1.2 --with mcp==2.2.0 clio-agent==0.9.6
clio-agent serve
```

Reserve `uvx` / `uv tool run` for disposable checks. The [installer reference](install/README.md)
covers paths, version selection, lifecycle commands and uninstalling.

## Documentation and contributing

Use the **[website documentation](https://clio.iowarp.ai/docs/)** for installation,
models, workspaces, plugins and examples. Repository references:

- [Architecture](docs/CLIO_AGENT_ARCHITECTURE.md) and [repository documentation index](docs/README.md)
- [Contributor quick start](docs/CONTRIBUTOR_QUICKSTART.md) and [AGENTS.md](AGENTS.md)
- [Adding tools](docs/MCP_TOOL_INTEGRATION.md) and [plugins, agents and flows](docs/PLUGINS_AND_FLOWS.md)
- [Roadmap](docs/design/roadmap.md)

## License and citation

BSD-3-Clause.

```bibtex
@software{clioagent2026,
  title  = {CLIO Agent: Autonomous Agent for Scientific Data Management},
  author = {IOWarp Team},
  year   = {2026},
  url    = {https://github.com/iowarp/clio-agent},
}
```
