intellif-aihub


Nameintellif-aihub JSON
Version 0.1.5 PyPI version JSON
download
home_pageNone
SummaryIntellif AI-hub SDK.
upload_time2025-07-18 02:21:13
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseNone
keywords ai-hub sdk intellif
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Intellif AI-Hub SDK

**Intellif AI-Hub** 官方 Python 开发包。  
一个 `Client` 对象即可完成数据集管理、标注统计、任务中心等常见操作,无需手写 HTTP 请求。

```
aihub_sdk/
├─ pyproject.toml
├─ requirements.txt
├─ src/aihub/
│   ├─ client.py
│   ├─ exceptions.py
│   ├─ models/…
│   ├─ services/…
│   └─ utils/…
└─ tests/
```

---

## 💻 安装

```bash
# PyPI 安装
pip install intellif-aihub
# 运行环境:Python ≥ 3.8
```

---

## 🚀 快速上手

```python
from aihub import Client

BASE  = "http://192.168.13.160:30021"
TOKEN = "eyJhb..."   # 或设置环境变量:export AI_HUB_TOKEN=...

with Client(base_url=BASE, token=TOKEN) as cli:
    # 1. 同时创建数据集 + 版本(上传本地 ZIP)
    ds_id, ver_id, tag = cli.dataset_management.create_dataset_and_version(
        dataset_name="cats",
        is_local_upload=True,
        local_file_path="/data/cats.zip",
        version_description="first release",
    )
    print("数据集标识:", tag)  # 输出:cats/V1

    # 2. 下载数据集
    cli.dataset_management.run_download(
        dataset_version_name=tag,
        local_dir="/tmp/cats",
        worker=8,
    )

    # 3. 获取标注平台全局统计
    stats = cli.labelfree.get_project_global_stats("cat-project")
    print("总标注数:", stats.global_stats.total_annotations)
```

---

## 🌍 环境变量

| 变量                       | 作用                                      | 默认值                           |
|----------------------------|-------------------------------------------|----------------------------------|
| `AI_HUB_TOKEN`             | API 鉴权 Token(可不在 `Client` 中显式传入) | –                                |

---

## 📦 打包 & 发布

项目采用 PEP 517 / `pyproject.toml` 构建规范。

```bash
# 1️⃣ 构建 wheel / sdist
python -m pip install --upgrade build
python -m build                 # 生成 dist/*.whl dist/*.tar.gz

# 2️⃣ 本地验证
pip install --force-reinstall dist/*.whl
python -c "import aihub, sys; print('SDK 版本:', aihub.__version__)"

# 3️⃣ 发布到 PyPI 或私有仓库
python -m pip install --upgrade twine
twine upload dist/*
```

---

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "intellif-aihub",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "AI-hub, sdk, intellif",
    "author": null,
    "author_email": "Platform Team <aihub@example.com>",
    "download_url": "https://files.pythonhosted.org/packages/25/b8/e6069d441b138c0d0b811f6da57bd32fb206344387e2d07de2972cf2d92a/intellif_aihub-0.1.5.tar.gz",
    "platform": null,
    "description": "# Intellif AI-Hub SDK\n\n**Intellif AI-Hub** \u5b98\u65b9 Python \u5f00\u53d1\u5305\u3002  \n\u4e00\u4e2a `Client` \u5bf9\u8c61\u5373\u53ef\u5b8c\u6210\u6570\u636e\u96c6\u7ba1\u7406\u3001\u6807\u6ce8\u7edf\u8ba1\u3001\u4efb\u52a1\u4e2d\u5fc3\u7b49\u5e38\u89c1\u64cd\u4f5c\uff0c\u65e0\u9700\u624b\u5199 HTTP \u8bf7\u6c42\u3002\n\n```\naihub_sdk/\n\u251c\u2500 pyproject.toml\n\u251c\u2500 requirements.txt\n\u251c\u2500 src/aihub/\n\u2502   \u251c\u2500 client.py\n\u2502   \u251c\u2500 exceptions.py\n\u2502   \u251c\u2500 models/\u2026\n\u2502   \u251c\u2500 services/\u2026\n\u2502   \u2514\u2500 utils/\u2026\n\u2514\u2500 tests/\n```\n\n---\n\n## \ud83d\udcbb \u5b89\u88c5\n\n```bash\n# PyPI \u5b89\u88c5\npip install intellif-aihub\n# \u8fd0\u884c\u73af\u5883\uff1aPython \u2265 3.8\n```\n\n---\n\n## \ud83d\ude80 \u5feb\u901f\u4e0a\u624b\n\n```python\nfrom aihub import Client\n\nBASE  = \"http://192.168.13.160:30021\"\nTOKEN = \"eyJhb...\"   # \u6216\u8bbe\u7f6e\u73af\u5883\u53d8\u91cf\uff1aexport AI_HUB_TOKEN=...\n\nwith Client(base_url=BASE, token=TOKEN) as cli:\n    # 1. \u540c\u65f6\u521b\u5efa\u6570\u636e\u96c6 + \u7248\u672c\uff08\u4e0a\u4f20\u672c\u5730 ZIP\uff09\n    ds_id, ver_id, tag = cli.dataset_management.create_dataset_and_version(\n        dataset_name=\"cats\",\n        is_local_upload=True,\n        local_file_path=\"/data/cats.zip\",\n        version_description=\"first release\",\n    )\n    print(\"\u6570\u636e\u96c6\u6807\u8bc6:\", tag)  # \u8f93\u51fa\uff1acats/V1\n\n    # 2. \u4e0b\u8f7d\u6570\u636e\u96c6\n    cli.dataset_management.run_download(\n        dataset_version_name=tag,\n        local_dir=\"/tmp/cats\",\n        worker=8,\n    )\n\n    # 3. \u83b7\u53d6\u6807\u6ce8\u5e73\u53f0\u5168\u5c40\u7edf\u8ba1\n    stats = cli.labelfree.get_project_global_stats(\"cat-project\")\n    print(\"\u603b\u6807\u6ce8\u6570:\", stats.global_stats.total_annotations)\n```\n\n---\n\n## \ud83c\udf0d \u73af\u5883\u53d8\u91cf\n\n| \u53d8\u91cf                       | \u4f5c\u7528                                      | \u9ed8\u8ba4\u503c                           |\n|----------------------------|-------------------------------------------|----------------------------------|\n| `AI_HUB_TOKEN`             | API \u9274\u6743 Token\uff08\u53ef\u4e0d\u5728 `Client` \u4e2d\u663e\u5f0f\u4f20\u5165\uff09 | \u2013                                |\n\n---\n\n## \ud83d\udce6 \u6253\u5305 & \u53d1\u5e03\n\n\u9879\u76ee\u91c7\u7528 PEP 517 / `pyproject.toml` \u6784\u5efa\u89c4\u8303\u3002\n\n```bash\n# 1\ufe0f\u20e3 \u6784\u5efa wheel / sdist\npython -m pip install --upgrade build\npython -m build                 # \u751f\u6210 dist/*.whl dist/*.tar.gz\n\n# 2\ufe0f\u20e3 \u672c\u5730\u9a8c\u8bc1\npip install --force-reinstall dist/*.whl\npython -c \"import aihub, sys; print('SDK \u7248\u672c:', aihub.__version__)\"\n\n# 3\ufe0f\u20e3 \u53d1\u5e03\u5230 PyPI \u6216\u79c1\u6709\u4ed3\u5e93\npython -m pip install --upgrade twine\ntwine upload dist/*\n```\n\n---\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Intellif AI-hub SDK.",
    "version": "0.1.5",
    "project_urls": null,
    "split_keywords": [
        "ai-hub",
        " sdk",
        " intellif"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "a85b07c3070b881a4d400034b9fe0a6769e89061e25562278fab8cfc9dbf4627",
                "md5": "7be99429873d45d12f4d0ae8924761b0",
                "sha256": "f1d5169e196c010dec0199cf0ebfe2152b5b6dbef2442fdd704108df81948ff6"
            },
            "downloads": -1,
            "filename": "intellif_aihub-0.1.5-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "7be99429873d45d12f4d0ae8924761b0",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 37112,
            "upload_time": "2025-07-18T02:21:11",
            "upload_time_iso_8601": "2025-07-18T02:21:11.366478Z",
            "url": "https://files.pythonhosted.org/packages/a8/5b/07c3070b881a4d400034b9fe0a6769e89061e25562278fab8cfc9dbf4627/intellif_aihub-0.1.5-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "25b8e6069d441b138c0d0b811f6da57bd32fb206344387e2d07de2972cf2d92a",
                "md5": "3997db7c81e77d336e06e5373d79b430",
                "sha256": "1f8979254b7047d15330955fc379cee428ef00500df81e7d62bc5e5efa467feb"
            },
            "downloads": -1,
            "filename": "intellif_aihub-0.1.5.tar.gz",
            "has_sig": false,
            "md5_digest": "3997db7c81e77d336e06e5373d79b430",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 33470,
            "upload_time": "2025-07-18T02:21:13",
            "upload_time_iso_8601": "2025-07-18T02:21:13.045681Z",
            "url": "https://files.pythonhosted.org/packages/25/b8/e6069d441b138c0d0b811f6da57bd32fb206344387e2d07de2972cf2d92a/intellif_aihub-0.1.5.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-18 02:21:13",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "intellif-aihub"
}
        
Elapsed time: 0.98034s