Current collected state Current
Observed since 21 Oct, 10:43 UTC
No superseded metadata states collected. Unchanged observations do not create new revisions.
PACKAGE EXPLORERView in registry
aif-normative-agent
PyPINorm-Native Agent SDK — Situation + Runtime loop over EDA / Normbase / Schemo HTTP APIs
Versions collected1
Direct dependencies5From release 0.3.11
Last observed21 Oct, 10:43 UTC
README
Version 0.3.11 documentationaif-normative-agent
PyPI distribution for the Norm-Native Agent SDK (normative_agent).
Thin HTTP client + Runtime tool loop over remote EDA, Normbase, and Schemo APIs. Does not ship Normbase, EDA server, Platform, MCP adapters, or Facilitator code.
Sibling package: aif-mcp (MCP tool surface over the same HTTP APIs).
Install
pip install aif-normative-agent
# optional DuckDuckGo fallback for built-in search_web:
pip install "aif-normative-agent[web]"
Editable install from monorepo (full-stack development):
pip install -e .
# at AIF repository root (aif-normbase)
SDK-only wheel build (this directory):
cd packaging/normative-agent
python sync_sources.py
python -m build --wheel
python verify_wheel.py dist/aif_normative_agent-0.3.10-py3-none-any.whl
python verify_wheel_imports.py dist/aif_normative_agent-0.3.10-py3-none-any.whl
Or from repo root:
pwsh ./scripts/publish/publish_normative_agent.ps1
Verify import
python -c "from normative_agent import NormativeAgent; print('ok')"
Configuration
| Variable | Purpose |
|---|---|
AIF_AGENT_API_KEY | Agent API key for NormativeAgent.from_api_key |
AIF_PLATFORM_URL | When set, SDK routes EDA/Normbase/Schemo via Platform integrator (recommended for external apps) |
EDA_BASE_URL | EDA HTTP API when not using Platform mode (default http://localhost:8002) |
NORMBASE_BASE_URL | Normbase HTTP API when not using Platform mode (default http://localhost:8001) |
SCHEMO_QUERY_BASE_URL | Schemo read API when not using Platform mode |
AIF_INTERNAL_SERVICE_TOKEN | Optional internal Bearer for mixed deployments |
AIF_WEB_SEARCH_ENABLED | Built-in search_web tool (default true) |
AIF_WEB_SEARCH_API_KEY / TAVILY_API_KEY | Tavily API key (primary provider for search_web) |
AIF_WEB_SEARCH_MAX_RESULTS | Default max results for search_web (default 5) |
Monorepo note
Source lives under normative_agent/, plus shared helpers ontology/schemo/client, ontology/schemo/contracts, and security/auth (same shared layer as aif-mcp).
Norm bind build logic stays in eda_agent/norm_projection.py (server). SDK formats EDA bound_norm_projections via normative_agent.situation.projection_format.
Developer guide: devkit/host-app/sdk/developer-guide.md (shipped with devkit; not in the wheel).
Host app docs: devkit/host-app/ — copy host-app/ folder to external projects.
Publish: pwsh ./scripts/publish/publish_normative_agent.ps1
Package scope
Bundled:
normative_agent(Situation + Runtime)ontology.schemo.client/contractssecurity.auth
Not bundled:
eda_agent,normbase,aif_platform,integrations,llm(docs live underdevkit/host-app/sdk/)
Optional LLM semantic governance uses monorepo llm or inject your own ToolCallingModel / SemanticTriggerClassifier.
Downloads & popularity
Awaiting observationsNo metric observations yet
Download counts and popularity will appear here as the collector receives them.
Versions 1
Collected releases| Version | Published | Direct dependencies | Open version |
|---|---|---|---|
| 0.3.11 | 6 Aug 2026 | 5 |
Package advisories
0No matching advisories collected
This describes our collected data; it is not a security assessment.
Metadata history
Meaningful changesRecord identity
package:56d4e7af8d26a2108aaf7856f26219f3af371ec6ae1992e0d4f78cafec185f69