sapporo-service
The sapporo-service is a standard implementation of the Global Alliance for Genomics and Health (GA4GH) Workflow Execution Service (WES) API specification. WES provides a standardized way to submit, monitor, and retrieve results from computational workflows across different platforms.
The service builds on GA4GH WES 1.1.0 with additional capabilities defined in the sapporo-wes-2.1.0 specification, including output file downloads, RO-Crate metadata generation, run deletion, and JWT authentication. Each workflow engine runs inside its own Docker container, so the service does not require any engine-specific installation.
Supported Workflow Engines
Quick Start
docker compose up -d
curl localhost:1122/service-info
See the Getting Started guide for a complete walkthrough including workflow submission.
Documentation
Full documentation is available at https://sapporo-wes.github.io/sapporo-service/.
- Getting Started - First-time tutorial: start the service, submit a workflow, retrieve results
- Installation - Install with pip or Docker, volume mount configuration
- Configuration - CLI options, environment variables, executable workflows
- WES Compatibility - GA4GH WES 1.1.0 and sapporo-wes 2.x compatibility matrix
- Authentication - JWT authentication, sapporo/external mode
- Architecture - run.sh abstraction, run directory, SQLite, RO-Crate, code structure
- RO-Crate - RO-Crate metadata generation specification
- Development - Development environment, testing, release process
- Agent Skill - LLM/agent reference: submit workflows, poll status, retrieve outputs via
curl - Agent Quick Reference - Essential 4 commands in ~40 lines
License
This project is licensed under the Apache-2.0 license. See the LICENSE file for details.
1 maintainer
Metadata
1 maintainer
Release files for sapporo 2.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sapporo-2.4.0.tar.gz | 11.9 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sapporo-2.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 12.0 MB
Release files / sapporo-2.4.0.tar.gz
| Download URL | sapporo-2.4.0.tar.gz |
|---|---|
| Size | 11.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
22e82e1f1ecfde57f0c5b42c6e5dc872b085cf3e461de2d01a831b4c08f90da9
|
|
BLAKE2b-256 checksum How to use checksums |
e51a57d1bc4ee4edcc6833262fddb671e6cb1a3779b1cf19f84af8beba8b4f66
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / sapporo-2.4.0-py3-none-any.whl
| Download URL | sapporo-2.4.0-py3-none-any.whl |
|---|---|
| Size | 81.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ce084d21fbbfb576924dd819db12058ffe06b0799f6fbaf8a1f37cdc2ec9a5b1
|
|
BLAKE2b-256 checksum How to use checksums |
5721ffedb337f4d88ed912a5ed6ecec237386e3d8cdb1d887cb3b204020dcafc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
