Skip to main content

eigenscope-sdk

Official Python SDK, CLI, RAG gate adapters, multimodal client, and loaded-model subspace hooks for EigenScope.

EigenScope enforces an explicit security boundary owned by your application:

raw input -> eigenscope.decompose(...) -> your model/provider call -> eigenscope.rehydrate(...)

Your application keeps full ownership of model credentials, provider selection, and execution—never wrapping or routing model-provider SDKs through third-party proxies.

Installation

pip install eigenscope-sdk==0.2.16

With optional PyTorch / Hugging Face model-hook runtime dependencies (connect_model):

pip install "eigenscope-sdk[model]==0.2.16"

Quick Start (Text & Tool Output Protection)

import os
from eigenscope_sdk import EigenScopeClient, DOMAIN_SEPARATION_POLICIES

client = EigenScopeClient(
    base_url="https://eigenscope.guardianai.network",  # or loopback http://127.0.0.1:8443 sidecar
    bearer_token=os.environ["EIGENSCOPE_API_KEY"],
)

decomposed = client.decompose(
    "Analyze Q4 acquisition terms for Redwood Biologics ($4,850,000 escrow).",
    policy=DOMAIN_SEPARATION_POLICIES["LEGAL_CONTRACT_MA_ANALYTICS"],
)

try:
    # Pass decomposed["task_core"] to your own model or provider call
    model_reply = your_model_call(decomposed["task_core"])
    restored = client.rehydrate(
        vault_ticket=decomposed["vault_ticket"],
        llm_task_output=model_reply,
    )
    print(restored["rehydrated_text"])
finally:
    client.scrub(decomposed["vault_ticket"])

Included Modules & Adapters

  • EigenScopeClient: Fail-closed client for /v1/decompose, /v1/rehydrate, /v1/vault/scrub, /v1/latent/project, RAG endpoints (/v1/rag/ingest, /v1/rag/retrieve, /v1/rag/evaluate), and multimodal endpoints (/v1/decompose/audio, /v1/decompose/image, /v1/decompose/video, /v1/rehydrate/media).
  • Domain Policies (DOMAIN_SEPARATION_POLICIES): Pre-configured policies including CODING_AGENT_FIREWALL, UNTRUSTED_TOOL_IPI_FIREWALL, HEALTHCARE_CLINICAL_PHI, LEGAL_CONTRACT_MA_ANALYTICS, TELECOM_6G_SEMANTIC_RAN, ROBOTICS_EMBODIED_VLA, and OIL_GAS_PRODUCTION_OPS.
  • RAG & Tool Quarantine (eigenscope_sdk.adapters): EigenScopeCandidateGate, EigenScopeLangChainRetriever, EigenScopeLlamaIndexPostprocessor, EigenScopeHaystackGate, ToolOutputQuarantine, and sanitize_tool_result.
  • Loaded-Model Hooks (connect_model): Direct residual-stream projection and suppression hooks (OrthoCoreResidualHook, create_residual_clamping_hook) for self-hosted Hugging Face, TransformerLens, and pyvene deployments.
  • CLI (eigenscope): eigenscope init, eigenscope doctor, eigenscope ci-verify, and eigenscope model-check (also runnable via python -m eigenscope_sdk).

Documentation & Security

License

Apache-2.0 — Copyright (c) Guardian AI Inc.

Metadata

Release files for eigenscope-sdk 0.2.16

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for eigenscope-sdk 0.2.16
File Size Uploaded Provenance Actions
eigenscope_sdk-0.2.16.tar.gz 65.5 kB Without provenance Details for eigenscope_sdk-0.2.16.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for eigenscope-sdk 0.2.16
File Interpreter ABI Platform Actions
eigenscope_sdk-0.2.16-py3-none-any.whl Python 3 none any Details for eigenscope_sdk-0.2.16-py3-none-any.whl

Total release size: 135.3 kB

Release files / eigenscope_sdk-0.2.16.tar.gz

Download URL eigenscope_sdk-0.2.16.tar.gz
Size 65.5 kB
Tags Source
SHA-256 checksum
How to use checksums
b9b6d695cbf1959ad07f6b237e0da572cd85f62825df8545200a1e032ad499da
BLAKE2b-256 checksum
How to use checksums
f1bfc3cadfe5b5353127a13f1e69030f7f16bc51c0a87b9005f03e8ad6b2b4f3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.3

Release files / eigenscope_sdk-0.2.16-py3-none-any.whl

Download URL eigenscope_sdk-0.2.16-py3-none-any.whl
Size 69.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
62ffc69ac6c4adfeabe807280be401baa611b2615c90021aa3bb49b0aa3ef0d6
BLAKE2b-256 checksum
How to use checksums
12bb1039b1882f590b8bc929dc8491b2a1d6b5be9ffa983478bd5e95115da8b3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.3

Security for eigenscope-sdk 0.2.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.16 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page