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.3.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.3.0.tar.gz | 11.9 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sapporo-2.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 11.9 MB
Release files / sapporo-2.3.0.tar.gz
| Download URL | sapporo-2.3.0.tar.gz |
|---|---|
| Size | 11.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9625b3774267921577a831ffc2e96c4b8502ec56e6d48c4d7da06d1133820b2c
|
|
BLAKE2b-256 checksum How to use checksums |
7eeb4f32d8c3f695fbeb74e880e55120119d3b199f7c5cb4eaecef473a1e7190
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","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.3.0-py3-none-any.whl
| Download URL | sapporo-2.3.0-py3-none-any.whl |
|---|---|
| Size | 75.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3b221c10002d0c63fc448ce920f63ba4d6c145b654e8cc8489da7a24b94c9ba9
|
|
BLAKE2b-256 checksum How to use checksums |
8a71a59b2754c5a32a7ff80f24df38895191407f08dd2bc3b404b9b47bbeae6c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","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}
|
