Skip to content

RExSyn Nexus Light – Overview & Full Edition Preview

Jump to bottom
Flamehaven edited this page Nov 27, 2025 · 1 revision

Purpose

RExSyn Nexus is shipped in two editions:

  • Light Edition

    • Safe, demo-friendly skeleton.
    • Uses a placeholder pipeline only (no secrets, no external executors).

  • Full Edition (Pro / B2B)

    • Production-grade system.
    • Includes complete scientific pipeline, infra, and governance.
    • Contact the maintainers for access.

Editions at a Glance

Capability Light Edition (OSS) Full Edition (Pro/B2B)
API /health, /predict (placeholder), /status, /result Full scientific job APIs & artifact/report endpoints
Pipeline Placeholder only Real structure prediction + MD + validation + reporting
Storage SQLite / in-memory ready Postgres, MinIO/S3, MLflow, Redis, etc.
Auth / Security Local JWKS, demo-safe JWKS-based auth, RBAC, audit trails, PII tools
Infra FastAPI app skeleton, basic Docker templates Helm charts, workers, observability stack
Governance Light checklist Full SIDRCE + SpicyFileReview, red/amber gates, audit artifacts
CI/CD Minimal tests & smoke checks CI/CD with quality gates, coverage, lint, drift checks (DFI-META)
Extensibility Simple skeleton External executors, plugin/add-on friendly architecture

Light Edition (Included)

API Surface

Minimal, demo-safe API:

  • GET /health – basic health check.
  • POST /predict – placeholder prediction endpoint (no real science executors).
  • GET /status – simple job status lookup.
  • GET /result – simple result retrieval.

Data Model

  • Job / Result models kept intentionally small.
  • Compatible with:
    • SQLite
    • In-memory backends
  • Designed for local demos and simple tests, not large-scale production.

Runtime & Environment

  • FastAPI application skeleton.
  • Minimal environment setup:
    • ALLOW_PLACEHOLDER_PIPELINE=1
    • Local JWKS for demo auth flows.
  • No secrets required; runs with safe defaults out-of-the-box.

Tests

  • Placeholder-level:
    • Basic unit tests.
    • Lightweight smoke tests for core endpoints.
  • Goal is to validate the skeleton, not scientific correctness.

Packaging

  • License: MIT
  • Containerization:
    • Basic Dockerfile
    • docker-compose templates for local runs
  • Intended as a clean, open foundation for extension.

Governance (Light)

  • Simple governance checklist for:
    • Basic code review.
    • Minimal safety & config checks.
  • Note:

    풀 SIDRCE + Spicy 검수는 프로 에디션에서 실행됩니다.

Full Edition (Available in Pro/B2B)

⚠️ The Full Edition is not bundled in the OSS/light repo.
Contact the maintainers for B2B enablement and deployment.

Scientific Pipeline

  • Structure Prediction Executors

    • Integration with tools like AlphaFold, ESM, etc.
    • Wired to real CLI / compute infrastructure.

  • Scientific Validation

    • Metrics and validation via:
      • DockQ
      • SAXS
      • PoseBusters
    • Metrics are persisted and exportable.

  • MD Refinement Pipeline

    • GROMACS-based MD refinement.
    • Refined PDB artifacts produced and stored.

  • Reporting

    • Automatic report generation:
      • PDFs
      • Graphs / plots
    • Artifacts stored in MinIO/S3 or compatible object storage.

Security & Auth

  • Authentication
    • JWKS-based auth (RS256 / ES256 support).
  • Authorization
    • RBAC / permissions model for users and orgs.
  • Compliance & Safety
    • Audit trails for important actions.
    • PII handling tools, org/user seeding, and policy checks.

Infra & Observability

  • Deployment

    • Helm charts for Kubernetes deployment.
    • Secrets management integration.

  • Workers & Storage

    • Redis / Celery workers for async jobs.
    • Postgres, MinIO, MLflow all wired together.

  • Observability

    • Prometheus / Grafana metrics.
    • Alerting hooks for ops.

  • CI/CD

    • CI pipelines with:
      • Quality gates
      • Test coverage thresholds
      • Linting
      • Drift checks (DFI-META / SIDRCE integrated)

Extensibility

  • External Executors
    • Configurable paths for:
      • Science CLIs
      • Storage endpoints
      • Custom tools
  • Plug-in / Add-on Friendly
    • Architecture designed for B2B:
      • Custom scientific tools
      • Custom reporting
      • Custom governance modules

Governance (Full)

  • Full SIDRCE governance pipeline.
  • SpicyFileReview (Spicy 검수) integrated.
  • Red/amber gates with:
    • Automatically generated audit artifacts.
    • Traceability for key decisions.

How to Use the Light Edition

  1. Run Locally

    • Use LOCAL_RUN.md for step-by-step instructions.
    • No external tools or secrets required.

  2. Try the Demo Flow

    • README.md includes a simple demo script:
      • predict → status → result
      • Uses a demo token and placeholder results.

  3. Safe by Default

    • All defaults are non-destructive and demo-safe.
    • Good starting point to:
      • Explore the API
      • Wire up mock UIs
      • Prototype integrations

How to Upgrade to the Full Edition

  1. Engage for B2B

    • Reach out to the maintainers/team.
    • We enable:
      • Real scientific executors
      • Production storage
      • Auth / RBAC
      • Deployment assets

  2. Tailored Add-ons

    • We can add:
      • Custom science tools and workflows
      • Org-specific reports and dashboards
      • Governance extensions
    • While keeping the open-source skeleton compatible and upgrade-safe.

Clone this wiki locally