# IOWarp Agents CLI
🤖 **Beautiful command-line interface for managing IOWarp scientific AI agents**
[](https://pypi.org/project/iowarp-agents/)
[](https://www.python.org/)
[](https://opensource.org/licenses/MIT)
## ✨ Features
- 🎨 **Beautiful UI** - Rich terminal interface with colors, tables, and interactive menus
- 🔍 **Agent Discovery** - Automatically fetches latest agents from GitHub
- 📦 **Easy Installation** - Interactive menus guide you through the process
- 🎯 **Multi-Platform** - Supports Claude Code (more platforms coming soon)
- 🌍 **Flexible Scope** - Install agents locally or globally
- 🚀 **Zero Config** - Works out of the box with sensible defaults
## 🚀 Quick Start
### Installation
```bash
# Install with uvx (recommended)
uvx iowarp-agents
# Or install globally with pip
pip install iowarp-agents
```
### Basic Usage
```bash
# List all available agents
iowarp-agents list
# Install an agent (interactive mode)
iowarp-agents install
# Install specific agent for Claude Code locally
iowarp-agents install workflow-orchestrator claude local
# Install with interactive menus
iowarp-agents install workflow-orchestrator
```
## 📋 Commands
| Command | Description | Example |
|---------|-------------|---------|
| `list` | List all available agents | `iowarp-agents list --detailed` |
| `install` | Install an agent | `iowarp-agents install data-io-expert claude local` |
| `status` | Show installation status | `iowarp-agents status` |
| `update` | Update agents to latest versions | `iowarp-agents update` |
## 🎯 Available Agents
| Agent | Specialization | Use Cases |
|-------|----------------|-----------|
| **data-io-expert** | Scientific data formats & I/O | HDF5, ADIOS, Parquet conversion |
| **analysis-viz-expert** | Data analysis & visualization | Statistical analysis, plotting |
| **hpc-performance-expert** | HPC & performance optimization | SLURM jobs, profiling |
| **research-doc-expert** | Research & documentation | Literature search, experiment tracking |
| **workflow-orchestrator** | Workflow & environment management | Pipeline creation, automation |
## 📦 Installation Examples
### Interactive Installation
```bash
$ iowarp-agents install
Select an agent to install:
1) 💾 Data Io Expert Scientific data formats and I/O operations
2) 📊 Analysis Viz Expert Data analysis and visualization
3) 🚀 Hpc Performance Expert HPC and performance optimization
4) 📚 Research Doc Expert Research literature and documentation
5) ⚙️ Workflow Orchestrator Workflow and environment management
Enter your choice [1]: 2
Select target platform:
1) Claude Code Claude Code AI assistant with subagent support
Enter your choice [1]: 1
Select installation scope:
1) Local project Install in current project only (./.claude/agents)
2) Global installation Install for all projects (~/.claude/agents)
Enter your choice [1]: 1
✅ Installation Successful!
Agent 'Analysis Viz Expert' has been installed to:
./.claude/agents/analysis-viz-expert.md
The agent is now available in Claude Code.
```
### Direct Installation
```bash
# Install workflow orchestrator for Claude Code in current project
$ iowarp-agents install workflow-orchestrator claude local
✅ Installation Successful!
Agent 'Workflow Orchestrator' has been installed to:
./.claude/agents/workflow-orchestrator.md
```
## 🎨 Beautiful Output
The CLI features rich, colorful output with:
- 🎯 **Interactive menus** with numbered options
- 📊 **Beautiful tables** for agent listings
- 🎨 **Colored panels** for status and results
- ⚡ **Progress indicators** for downloads
- 💡 **Helpful guidance** throughout the process
## 🔧 Advanced Usage
### List Agents with Details
```bash
iowarp-agents list --detailed
```
### Install Multiple Agents
```bash
# Install for different scopes
iowarp-agents install data-io-expert claude global
iowarp-agents install analysis-viz-expert claude local
```
## 🤝 Contributing
We welcome contributions! See our [contribution guide](https://github.com/iowarp/iowarp-agents#contributing) for details.
## 📚 Related Projects
- [IOWarp MCPs](https://github.com/iowarp/iowarp-mcps) - MCP servers for scientific computing
- [IOWarp Agents](https://github.com/iowarp/iowarp-agents) - Specialized AI subagents
- [IOWarp Website](https://iowarp.github.io/iowarp-agents/) - Browse agents online
## 📄 License
MIT License - see [LICENSE](LICENSE) file for details.
---
*Part of the [IOWarp](https://github.com/iowarp) ecosystem for scientific computing*
Raw data
{
"_id": null,
"home_page": null,
"name": "iowarp-agents",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "agents, ai, claude, cli, computing, scientific",
"author": null,
"author_email": "IOWarp Team <team@iowarp.com>",
"download_url": "https://files.pythonhosted.org/packages/d3/7b/dd49412913bfb1eca3d368ad2870e7addf18338ca12f8db8f2e1727447aa/iowarp_agents-0.1.0.tar.gz",
"platform": null,
"description": "# IOWarp Agents CLI\n\n\ud83e\udd16 **Beautiful command-line interface for managing IOWarp scientific AI agents**\n\n[](https://pypi.org/project/iowarp-agents/)\n[](https://www.python.org/)\n[](https://opensource.org/licenses/MIT)\n\n## \u2728 Features\n\n- \ud83c\udfa8 **Beautiful UI** - Rich terminal interface with colors, tables, and interactive menus\n- \ud83d\udd0d **Agent Discovery** - Automatically fetches latest agents from GitHub\n- \ud83d\udce6 **Easy Installation** - Interactive menus guide you through the process\n- \ud83c\udfaf **Multi-Platform** - Supports Claude Code (more platforms coming soon)\n- \ud83c\udf0d **Flexible Scope** - Install agents locally or globally\n- \ud83d\ude80 **Zero Config** - Works out of the box with sensible defaults\n\n## \ud83d\ude80 Quick Start\n\n### Installation\n\n```bash\n# Install with uvx (recommended)\nuvx iowarp-agents\n\n# Or install globally with pip\npip install iowarp-agents\n```\n\n### Basic Usage\n\n```bash\n# List all available agents\niowarp-agents list\n\n# Install an agent (interactive mode)\niowarp-agents install\n\n# Install specific agent for Claude Code locally\niowarp-agents install workflow-orchestrator claude local\n\n# Install with interactive menus\niowarp-agents install workflow-orchestrator\n```\n\n## \ud83d\udccb Commands\n\n| Command | Description | Example |\n|---------|-------------|---------|\n| `list` | List all available agents | `iowarp-agents list --detailed` |\n| `install` | Install an agent | `iowarp-agents install data-io-expert claude local` |\n| `status` | Show installation status | `iowarp-agents status` |\n| `update` | Update agents to latest versions | `iowarp-agents update` |\n\n## \ud83c\udfaf Available Agents\n\n| Agent | Specialization | Use Cases |\n|-------|----------------|-----------|\n| **data-io-expert** | Scientific data formats & I/O | HDF5, ADIOS, Parquet conversion |\n| **analysis-viz-expert** | Data analysis & visualization | Statistical analysis, plotting |\n| **hpc-performance-expert** | HPC & performance optimization | SLURM jobs, profiling |\n| **research-doc-expert** | Research & documentation | Literature search, experiment tracking |\n| **workflow-orchestrator** | Workflow & environment management | Pipeline creation, automation |\n\n## \ud83d\udce6 Installation Examples\n\n### Interactive Installation\n```bash\n$ iowarp-agents install\n\nSelect an agent to install:\n\n1) \ud83d\udcbe Data Io Expert Scientific data formats and I/O operations\n2) \ud83d\udcca Analysis Viz Expert Data analysis and visualization \n3) \ud83d\ude80 Hpc Performance Expert HPC and performance optimization\n4) \ud83d\udcda Research Doc Expert Research literature and documentation\n5) \u2699\ufe0f Workflow Orchestrator Workflow and environment management\n\nEnter your choice [1]: 2\n\nSelect target platform:\n\n1) Claude Code Claude Code AI assistant with subagent support\n\nEnter your choice [1]: 1\n\nSelect installation scope:\n\n1) Local project Install in current project only (./.claude/agents) \n2) Global installation Install for all projects (~/.claude/agents)\n\nEnter your choice [1]: 1\n\n\u2705 Installation Successful!\n\nAgent 'Analysis Viz Expert' has been installed to:\n./.claude/agents/analysis-viz-expert.md\n\nThe agent is now available in Claude Code.\n```\n\n### Direct Installation\n```bash\n# Install workflow orchestrator for Claude Code in current project\n$ iowarp-agents install workflow-orchestrator claude local\n\n\u2705 Installation Successful!\n\nAgent 'Workflow Orchestrator' has been installed to:\n./.claude/agents/workflow-orchestrator.md\n```\n\n## \ud83c\udfa8 Beautiful Output\n\nThe CLI features rich, colorful output with:\n- \ud83c\udfaf **Interactive menus** with numbered options\n- \ud83d\udcca **Beautiful tables** for agent listings \n- \ud83c\udfa8 **Colored panels** for status and results\n- \u26a1 **Progress indicators** for downloads\n- \ud83d\udca1 **Helpful guidance** throughout the process\n\n## \ud83d\udd27 Advanced Usage\n\n### List Agents with Details\n```bash\niowarp-agents list --detailed\n```\n\n### Install Multiple Agents\n```bash\n# Install for different scopes\niowarp-agents install data-io-expert claude global\niowarp-agents install analysis-viz-expert claude local\n```\n\n## \ud83e\udd1d Contributing\n\nWe welcome contributions! See our [contribution guide](https://github.com/iowarp/iowarp-agents#contributing) for details.\n\n## \ud83d\udcda Related Projects\n\n- [IOWarp MCPs](https://github.com/iowarp/iowarp-mcps) - MCP servers for scientific computing\n- [IOWarp Agents](https://github.com/iowarp/iowarp-agents) - Specialized AI subagents\n- [IOWarp Website](https://iowarp.github.io/iowarp-agents/) - Browse agents online\n\n## \ud83d\udcc4 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n---\n\n*Part of the [IOWarp](https://github.com/iowarp) ecosystem for scientific computing*",
"bugtrack_url": null,
"license": null,
"summary": "Beautiful CLI for managing IOWarp scientific AI agents",
"version": "0.1.0",
"project_urls": {
"Documentation": "https://iowarp.github.io/iowarp-agents/",
"Homepage": "https://github.com/iowarp/iowarp-agents",
"Issues": "https://github.com/iowarp/iowarp-agents/issues",
"Repository": "https://github.com/iowarp/iowarp-agents"
},
"split_keywords": [
"agents",
" ai",
" claude",
" cli",
" computing",
" scientific"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c3e7461d173b54ed23d7a2f13cbe778f533ce72fa3a36c1edeb49115a06f56be",
"md5": "ddc35072b8f28653d021da2a077a21c7",
"sha256": "68c92aad8fc825fe070000cef471eb0d2734876801a5648ff1dd686bbd351abf"
},
"downloads": -1,
"filename": "iowarp_agents-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ddc35072b8f28653d021da2a077a21c7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 8398,
"upload_time": "2025-07-29T07:31:49",
"upload_time_iso_8601": "2025-07-29T07:31:49.457304Z",
"url": "https://files.pythonhosted.org/packages/c3/e7/461d173b54ed23d7a2f13cbe778f533ce72fa3a36c1edeb49115a06f56be/iowarp_agents-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "d37bdd49412913bfb1eca3d368ad2870e7addf18338ca12f8db8f2e1727447aa",
"md5": "521aa075718327cfcda389dc49f8c7e9",
"sha256": "2dbe593f110086af63c39db00d502415c4cce05536406fade4d2693b9a66cf72"
},
"downloads": -1,
"filename": "iowarp_agents-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "521aa075718327cfcda389dc49f8c7e9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 9217,
"upload_time": "2025-07-29T07:31:50",
"upload_time_iso_8601": "2025-07-29T07:31:50.834565Z",
"url": "https://files.pythonhosted.org/packages/d3/7b/dd49412913bfb1eca3d368ad2870e7addf18338ca12f8db8f2e1727447aa/iowarp_agents-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-29 07:31:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "iowarp",
"github_project": "iowarp-agents",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "iowarp-agents"
}
JSON
