synaster-client 0.12.1__tar.gz

synaster_client-0.12.1/.gitignore

@@ -0,0 +1,66 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+dist/
+build/
+
+# Pixi
+.pixi/
+
+# Virtual environments
+.venv/
+venv/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Runtime
+volcano_backend/workspace/
+# volcano-services.sh launcher logs
+/logs/
+# Release state and provenance are host-local. They survive Git checkouts but
+# must never be committed.
+/.deploy/
+# Generated at frontend build time and copied into dist by Vite.
+/frontend/public/release.json
+
+# Kombu filesystem transport 的 pidbox 控制消息会泄到启动 cwd
+# (已在 celery_app.py 里显式指向 CELERY_STATE_DIR，但保留兜底以防手动起服务)
+/control/
+/reply/
+
+# nf-pipelines submodule runtime artefacts (must NOT be tracked by main repo)
+volcano_backend/nf-pipelines/outputs/
+volcano_backend/nf-pipelines/work/
+volcano_backend/nf-pipelines/.nextflow/
+volcano_backend/nf-pipelines/.nextflow.log*
+volcano_backend/nf-pipelines/.pixi/
+volcano_backend/nf-pipelines/tools/installed/
+
+# dotenv
+.env
+!.env.example
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Pixi lock (keep in repo for reproducibility)
+# pixi.lock
+openspec/
+.cursor/
+.codex/
+
+# Bohrium OpenAPI 网关代码（独立仓库，仅本地参考，不随主仓库提交）
+bohrium_gateway/openapi/

synaster_client-0.12.1/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: synaster-client
+Version: 0.12.1
+Summary: Official Python SDK and CLI for SynAster
+Project-URL: Homepage, https://syn-aster.bohrium.com
+Project-URL: Documentation, https://syn-aster.bohrium.com
+Project-URL: Repository, https://github.com/macroversus/SynAsterHub
+Project-URL: Issues, https://github.com/macroversus/SynAsterHub/issues
+Author: SynAster Team
+Keywords: ai-for-science,bioinformatics,bohrium,cli,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.28
+Description-Content-Type: text/markdown
+
+# synaster-client
+
+Official lightweight Python SDK and `synaster` command-line client for
+SynAster. It calls the existing Bohrium OpenAPI and does not install or run
+FastAPI, Celery, Redis, Nextflow, or scientific tool containers.
+
+Requires Python 3.10 or newer.
+
+## Install
+
+```bash
+pipx install synaster-client
+synaster --version
+
+# one-off execution
+uvx --from synaster-client synaster --version
+```
+
+The console script and module entrypoint are equivalent:
+
+```bash
+synaster skills --json
+python -m synaster_client skills --json
+```
+
+## Authenticate and run
+
+AccessKey values are only accepted from `SYNASTER_ACCESS_KEY` or one line of
+stdin via `--access-key-stdin`. There is intentionally no
+`--access-key VALUE` option, and secret values are rejected in config files.
+
+```bash
+export SYNASTER_ACCESS_KEY="<your Bohrium AccessKey>"
+
+synaster doctor
+synaster describe adabmdca
+synaster run adabmdca \
+  --input family_msa.fasta \
+  --file query=query.fasta
+```
+
+Use `submit` for a one-shot POST, then resume from the returned task ID:
+
+```bash
+synaster submit tmpred --input proteins.fasta
+synaster wait <task-id>
+synaster download <task-id>
+```
+
+For `--mode bohr`, the CLI refreshes live machine prices and requires an
+explicit per-command charge confirmation. POST requests are never
+automatically retried.
+
+See the repository's `docs/synaster-cli-sop.md` for the complete command,
+JSON, exit-code, recovery, download, and Python SDK reference.

synaster_client-0.12.1/README.md

@@ -0,0 +1,55 @@
+# synaster-client
+
+Official lightweight Python SDK and `synaster` command-line client for
+SynAster. It calls the existing Bohrium OpenAPI and does not install or run
+FastAPI, Celery, Redis, Nextflow, or scientific tool containers.
+
+Requires Python 3.10 or newer.
+
+## Install
+
+```bash
+pipx install synaster-client
+synaster --version
+
+# one-off execution
+uvx --from synaster-client synaster --version
+```
+
+The console script and module entrypoint are equivalent:
+
+```bash
+synaster skills --json
+python -m synaster_client skills --json
+```
+
+## Authenticate and run
+
+AccessKey values are only accepted from `SYNASTER_ACCESS_KEY` or one line of
+stdin via `--access-key-stdin`. There is intentionally no
+`--access-key VALUE` option, and secret values are rejected in config files.
+
+```bash
+export SYNASTER_ACCESS_KEY="<your Bohrium AccessKey>"
+
+synaster doctor
+synaster describe adabmdca
+synaster run adabmdca \
+  --input family_msa.fasta \
+  --file query=query.fasta
+```
+
+Use `submit` for a one-shot POST, then resume from the returned task ID:
+
+```bash
+synaster submit tmpred --input proteins.fasta
+synaster wait <task-id>
+synaster download <task-id>
+```
+
+For `--mode bohr`, the CLI refreshes live machine prices and requires an
+explicit per-command charge confirmation. POST requests are never
+automatically retried.
+
+See the repository's `docs/synaster-cli-sop.md` for the complete command,
+JSON, exit-code, recovery, download, and Python SDK reference.

synaster_client-0.12.1/pyproject.toml

@@ -0,0 +1,42 @@
+[project]
+name = "synaster-client"
+version = "0.12.1"
+description = "Official Python SDK and CLI for SynAster"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [
+    { name = "SynAster Team" },
+]
+keywords = ["ai-for-science", "bioinformatics", "bohrium", "cli", "sdk"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+dependencies = [
+    "httpx>=0.28",
+]
+
+[project.urls]
+Homepage = "https://syn-aster.bohrium.com"
+Documentation = "https://syn-aster.bohrium.com"
+Repository = "https://github.com/macroversus/SynAsterHub"
+Issues = "https://github.com/macroversus/SynAsterHub/issues"
+
+[project.scripts]
+synaster = "synaster_client.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/synaster_client"]

synaster_client-0.12.1/src/synaster_client/__init__.py

@@ -0,0 +1,54 @@
+"""Official SynAster Python SDK."""
+
+from .client import DEFAULT_BASE_URL, SynAsterClient, infer_input_type, redact
+from .errors import (
+    SynAsterApiError,
+    SynAsterAuthError,
+    SynAsterConfirmationError,
+    SynAsterContractVersionError,
+    SynAsterDownloadError,
+    SynAsterError,
+    SynAsterProtocolError,
+    SynAsterRemoteTaskError,
+    SynAsterTransportError,
+    SynAsterValidationError,
+    SynAsterWaitError,
+)
+from .models import (
+    BohrChargeConfirmation,
+    BohrMachineOption,
+    BohrOptionsData,
+    RunResult,
+    SkillContract,
+    StandardResponse,
+    TaskStatus,
+    TaskSubmission,
+)
+from .version import __version__
+
+__all__ = [
+    "__version__",
+    "DEFAULT_BASE_URL",
+    "SynAsterClient",
+    "infer_input_type",
+    "redact",
+    "SynAsterError",
+    "SynAsterApiError",
+    "SynAsterAuthError",
+    "SynAsterConfirmationError",
+    "SynAsterContractVersionError",
+    "SynAsterDownloadError",
+    "SynAsterProtocolError",
+    "SynAsterRemoteTaskError",
+    "SynAsterTransportError",
+    "SynAsterValidationError",
+    "SynAsterWaitError",
+    "BohrChargeConfirmation",
+    "BohrMachineOption",
+    "BohrOptionsData",
+    "RunResult",
+    "SkillContract",
+    "StandardResponse",
+    "TaskStatus",
+    "TaskSubmission",
+]

synaster_client-0.12.1/src/synaster_client/__main__.py

@@ -0,0 +1,5 @@
+"""Module entrypoint for `python -m synaster_client`."""
+
+from .cli import main
+
+raise SystemExit(main())