# iceos-client
Typed async Python client for the iceOS Orchestrator API.
## Install
```bash
pip install iceos-client
```
## Quickstart
```python
import asyncio
from ice_client import IceClient
async def main():
client = IceClient("http://localhost:8000")
# Quick discovery call (names only) to verify connectivity
meta = await client.list_components()
print("components (names only):", list(meta.keys()))
exec_id = await client.run_bundle(
"chatkit.rag_chat",
inputs={
"query": "Two-sentence summary for Stefano.",
"org_id": "demo_org",
"user_id": "demo_user",
"session_id": "chat_demo"
},
# If bundle is not pre-registered on the server, auto-register from YAML:
blueprint_yaml_path="Plugins/bundles/chatkit/workflows/rag_chat.yaml",
wait_seconds=5,
)
print("execution_id:", exec_id)
asyncio.run(main())
```
## Smoke test (Dockerized)
```bash
docker run --rm -t --network host python:3.11.9-slim bash -lc "\
python -m pip install -U pip && \
pip install -q iceos-client && \
python - <<'PY'\
import asyncio
from ice_client import IceClient
async def main():
c = IceClient('http://localhost:8000')
res = await c.list_library(limit=5)
print('OK:', isinstance(res, dict), 'items:', len(res.get('items', [])))
await c.close()
asyncio.run(main())
PY"
```
Raw data
{
"_id": null,
"home_page": null,
"name": "iceos-client",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.11",
"maintainer_email": null,
"keywords": "iceos, client, async, httpx, orchestrator, mcp, agents",
"author": "iceOS Developers",
"author_email": "dev@iceos.dev",
"download_url": "https://files.pythonhosted.org/packages/c1/fb/ed3c462d45627cf2aaaef7ab6051a52390651e6c3d02f99e771919698a20/iceos_client-0.1.2.tar.gz",
"platform": null,
"description": "# iceos-client\n\nTyped async Python client for the iceOS Orchestrator API.\n\n## Install\n\n```bash\npip install iceos-client\n```\n\n## Quickstart\n\n```python\nimport asyncio\nfrom ice_client import IceClient\n\nasync def main():\n client = IceClient(\"http://localhost:8000\")\n # Quick discovery call (names only) to verify connectivity\n meta = await client.list_components()\n print(\"components (names only):\", list(meta.keys()))\n exec_id = await client.run_bundle(\n \"chatkit.rag_chat\",\n inputs={\n \"query\": \"Two-sentence summary for Stefano.\",\n \"org_id\": \"demo_org\",\n \"user_id\": \"demo_user\",\n \"session_id\": \"chat_demo\"\n },\n # If bundle is not pre-registered on the server, auto-register from YAML:\n blueprint_yaml_path=\"Plugins/bundles/chatkit/workflows/rag_chat.yaml\",\n wait_seconds=5,\n )\n print(\"execution_id:\", exec_id)\n\nasyncio.run(main())\n```\n\n## Smoke test (Dockerized)\n```bash\ndocker run --rm -t --network host python:3.11.9-slim bash -lc \"\\\n python -m pip install -U pip && \\\n pip install -q iceos-client && \\\n python - <<'PY'\\\nimport asyncio\nfrom ice_client import IceClient\nasync def main():\n c = IceClient('http://localhost:8000')\n res = await c.list_library(limit=5)\n print('OK:', isinstance(res, dict), 'items:', len(res.get('items', [])))\n await c.close()\nasyncio.run(main())\nPY\"\n```\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Typed async Python client for the iceOS Orchestrator API",
"version": "0.1.2",
"project_urls": {
"Homepage": "https://github.com/noozrad/iceOS",
"Repository": "https://github.com/noozrad/iceOS"
},
"split_keywords": [
"iceos",
" client",
" async",
" httpx",
" orchestrator",
" mcp",
" agents"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "46c9a9a9b350f4982bfea6f328df633d87ca3973816e527c1ae9a271b2cf64b8",
"md5": "3706df9bf4f3f3ef77938ee14f856d83",
"sha256": "189b5e29fcb541467277344e15e503e387e6c0db81aa9906faa17512177e106a"
},
"downloads": -1,
"filename": "iceos_client-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3706df9bf4f3f3ef77938ee14f856d83",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.11",
"size": 11767,
"upload_time": "2025-08-25T01:10:15",
"upload_time_iso_8601": "2025-08-25T01:10:15.031770Z",
"url": "https://files.pythonhosted.org/packages/46/c9/a9a9b350f4982bfea6f328df633d87ca3973816e527c1ae9a271b2cf64b8/iceos_client-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c1fbed3c462d45627cf2aaaef7ab6051a52390651e6c3d02f99e771919698a20",
"md5": "24da2521a06bea4a781db62fb846c3d4",
"sha256": "89b66b8be66e2a9f63e63980b15447932e6aee52ca54a7d6db7938536a26ab47"
},
"downloads": -1,
"filename": "iceos_client-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "24da2521a06bea4a781db62fb846c3d4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.11",
"size": 10587,
"upload_time": "2025-08-25T01:10:16",
"upload_time_iso_8601": "2025-08-25T01:10:16.220179Z",
"url": "https://files.pythonhosted.org/packages/c1/fb/ed3c462d45627cf2aaaef7ab6051a52390651e6c3d02f99e771919698a20/iceos_client-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-25 01:10:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "noozrad",
"github_project": "iceOS",
"github_not_found": true,
"lcname": "iceos-client"
}
JSON
