菜单
Build workflows with the rahcp Python SDK & CLI: upload/download HCP S3 objects, bulk transfers, IIIF image downloads, Transkribus exports, transfer tracking, namespace admin. Triggers: rahcp, HCP, IIIF, Transkribus, presigned URL, bulk upload, bulk download, transfer tracker, S3 objects.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/AI-Riksarkivet/ra-hcp --skill hcp-sdk命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
HCP backend design patterns and mock server conventions. Use when: writing FastAPI endpoints, adding mock server routes, creating Pydantic schemas, or working with backend Python code.
HCP frontend design patterns, component conventions, and architecture guide. Use when: writing Svelte components, adding features, refactoring, creating pages, working with remote functions, settings forms, dialogs, or any frontend code in this project.
Write and evaluate effective Python tests using pytest. Use when writing tests, reviewing test code, debugging test failures, or improving test coverage. Covers test design, fixtures, parameterization, mocking, and async testing.
基于 SOC 职业分类
正在显示 SKILL.md
| name | hcp-sdk |
| description | Build workflows with the rahcp Python SDK & CLI: upload/download HCP S3 objects, bulk transfers, IIIF image downloads, Transkribus exports, transfer tracking, namespace admin. Triggers: rahcp, HCP, IIIF, Transkribus, presigned URL, bulk upload, bulk download, transfer tracker, S3 objects. |
Async Python SDK & CLI for the Hitachi Content Platform (HCP) Unified API — S3 object storage, IIIF image downloads, and Transkribus exports, with resumable parallel bulk transfers.
rahcp bundles everything; there are no separate rahcp-* packages. Heavy deps
are extras.
pip install rahcp # client, CLI, IIIF, Transkribus, tracker
pip install "rahcp[validate]" # image validation (Pillow)
pip install "rahcp[etl]" # NATS JetStream (rahcp_etl)
pip install "rahcp[alto]" # Transkribus PAGE->ALTO (ocrd)
pip install "rahcp[postgres]" # Postgres tracker backend
pip install "rahcp[all]" # everything
Import names are stable: from rahcp_client import HCPClient,
from rahcp_iiif import download_batch, from rahcp_transkribus import export_collection.
POST /presign → signed URL
→ direct PUT/GET to HCP S3; data never flows through the API server. Files
≥ 100 MB use multipart automatically.tracker; completed keys are
skipped instantly on re-run. Persist the tracker DB across runs.409;
ConflictPolicy.overwrite and --check-updates delete-then-PUT. moto and the
mock server allow PUT-overwrite, so they do NOT reproduce the 409 — test
overwrite against real HCP.import asyncio
from pathlib import Path
from rahcp import HCPClient # reads HCP_ENDPOINT / HCP_USERNAME / HCP_PASSWORD / HCP_TENANT
async def main():
async with HCPClient.from_env() as client:
await client.s3.upload("my-bucket", "data/file.jpg", Path("file.jpg"))
print(await client.s3.list_objects("my-bucket", prefix="data/"))
asyncio.run(main())
rahcp s3 upload-all my-bucket ./scans --workers 20 --include '*.jpg' --validate
Config lives at ~/.rahcp/config.yaml. For a project-local config you MUST pass
--config or every command 401s (it silently reads the default path):
rahcp --config .rahcp/config.yaml s3 ls
| Task | Reference |
|---|---|
| S3 upload/download, list/copy/delete, presign, staging, conflict policy | references/s3.md |
IIIF image downloads + query_params + IIIF→HCP | references/iiif.md |
Transkribus export/upload, scheduled sync, --check-updates | references/transkribus.md |
| Tracker API, namespaces, auth, validation, errors, full config | references/reference.md |
| Debug logs, perf tuning, long transfers, tracker inspection | references/troubleshooting.md |