来源模杰制

Installation

30-Second Quickstart

```python from moralstack import govern from openai import OpenAI

Quick example

```python from openai import OpenAI from moralstack import govern

client = govern(OpenAI())

SDK Usage

Use MoralStack as a governance wrapper around your existing OpenAI client — no server, no HTTP, no separate process.

```python from moralstack import govern from openai import OpenAI

client = govern(OpenAI())

response = client.chat.completions.create( model="gpt-4o", messages=[{"role": "user", "content": "How do I pick a lock?"}], )

print(response.content)

Configure

```bash cp .env.minimal .env

edit .env and set OPENAI_API_KEY=sk-...

```

GovernanceConfig

from moralstack import govern, GovernanceConfig
from openai import OpenAI

client = govern(
    OpenAI(),
    config=GovernanceConfig(
        domain_overlay="healthcare",     # enforce a specific domain overlay
        failure_policy="passthrough",    # on pipeline error: call OpenAI directly (unsafe)
        observability_mode="file_only",  # write JSONL audit trail
        jsonl_dir="logs/audit",
    ),
)

All parameters default to sensible values. Minimum required: OPENAI_API_KEY in environment.

Configuration

Environment is loaded via moralstack/utils/env_loader.py.

• .env values are loaded with override=True (non-empty .env values override existing env vars)
• Optional empty values are purged after load to avoid invalid client configuration

.env

MORALSTACK_DB_PATH=moralstack.db MORALSTACK_UI_USERNAME=admin MORALSTACK_UI_PASSWORD=your_password

Start:

Full OpenAI API compatibility:

print(response.choices[0].message.content)

SDK model resolution

When you use govern(), MoralStack runs two separate model planes:

1. Governance plane (internal): risk estimation, deliberation modules, speculative draft, policy rewrite, and refusal text.
2. Generation plane (your client): the final user-visible response when final_action is NORMAL_COMPLETE or SAFE_COMPLETE.

The model passed in client.chat.completions.create(model="...") controls only the final response. OPENAI_MODEL and MORALSTACK_*_MODEL variables control only the internal governance pipeline. Neither side overrides the other.

When final_action is REFUSE, your wrapped client is not called for generation.

Default models by component

For the full variable reference see INSTALL.md and docs/modules/*.md.

---