Skip to content

ra-hcp

Unified platform for Hitachi Content Platform — S3 storage, management API, and IIIF image workflows.

Get started API docs
Riksarkivet

ra-hcp

Tests Docs Storybook CodeQL Scorecard

Features

  • S3 Object Storage

    Presigned URL transfers, multipart uploads, bulk operations with crash-safe resume, and staging/commit patterns for atomic writes.

    S3 API

  • Management API

    Full HCP MAPI coverage — tenants, namespaces, users, groups, compliance, replication, and system administration.

    MAPI guide

  • Python SDK & CLI

    Async client with automatic retries, batch presigning, IIIF image downloads, and a Typer CLI for scripting.

    SDK docs

  • Web Dashboard

    SvelteKit 2 frontend for browsing buckets, managing namespaces, monitoring storage, and administering users.

    Architecture

Quick start

make setup          # Install Deno + uv and all dependencies
make run-api-mock   # Start mock backend (no HCP credentials needed)
make frontend-dev   # Start frontend dev server

make setup          # Install Deno + uv and all dependencies
make run-api        # Start backend with real HCP credentials
make frontend-dev   # Start frontend dev server

uv pip install rahcp

rahcp auth whoami
rahcp s3 ls
rahcp s3 upload-all my-bucket ./data --workers 20

Tech stack

Layer Technology
Frontend SvelteKit 2, Svelte 5, Tailwind CSS 4, Deno
Backend FastAPI, boto3, Python 3.13, uv
SDK rahcp-client, rahcp-cli, rahcp-tracker, rahcp-iiif
Caching Redis
Docs Zensical
CI/CD GitHub Actions, Docker, Helm