FAQ & Troubleshooting

General

What is IOWarp?

IOWarp is a context orchestration platform for agentic AI in scientific computing. It provides a high-performance runtime, SDK, and agent toolkit (CLIO Kit) for bridging AI agents with HPC infrastructure.

What is the license?

IOWarp is released under the BSD 3-Clause License.

Where can I get help?

• Zulip Chat: iowarp.zulipchat.com
• GitHub Issues: github.com/iowarp/clio-core/issues
• Discussions: github.com/orgs/iowarp/discussions
• Email: grc@illinoistech.edu

---

Troubleshooting

"Could not start TCP server on any host from hostfile"

This error occurs when another process is using the port the CLIO Runtime is trying to bind to:

clio_run start
ERROR: Could not start TCP server on any host from hostfile
Port attempted: 9128

Solution:

1. Check which process is using the port:

   # Linux
   sudo lsof -i :9128 -P -n
   sudo netstat -tulpn | grep :9128
   
   # macOS
   sudo lsof -nP -iTCP:9128 | grep LISTEN

2. Stop the existing CLIO Runtime:

   clio_run stop

3. Or kill the process directly:

   pkill -9 clio_run start

warning

When using SSH/pssh in distributed environments, avoid wildcard patterns like pkill clio_*. Use the full executable name to prevent killing the SSH connection before the runtime.