tenaxisos-sdk

Python SDK and CLI for building, testing, signing, and publishing TenaxisOS packages — agents, MCP servers, and playbooks that install into a TenaxisOS kernel and can be shared through the Tenaxis Hub.

What this is

tenaxisos-sdk is the toolkit for building community capabilities for TenaxisOS:

• Author agents and MCP servers as plain Python, using Agent and MCPServer base classes with host-brokered LLM/tool/file access — no network calls, secrets, or infrastructure of your own to manage.
• Test locally against LocalMockHost, a fake host that lets you drive and assert on agent/tool behavior entirely offline.
• Build a signed, versioned package manifest from your code.
• Publish to the Tenaxis Hub (or import straight into a kernel you control for local development) so others can discover and install it.

Getting started

The fastest way in is examples/ — three runnable, heavily-commented examples, one per authoring surface (native agent, MCP server, LangChain framework adapter). Each has its own tests you can run immediately, no kernel or network required:

pip install -e ".[dev,mcp,langchain]"
pytest examples/minimal_text_agent/test_agent.py -v

See examples/README.md for which one to start with.

Documentation

Prose tutorials — go here once you know which capability you're building and want more depth than the examples give:

• Writing a native agent
• Writing an MCP server
• Local testing with LocalMockHost
• Publishing and installing
• Runtime permission outcomes

What this contains

tenaxisos-sdk is published on PyPI: https://pypi.org/project/tenaxisos-sdk/. Version 0.2.3 is the current package release; 0.2.0 remains the SDK API contract version.

Prerequisites

• Python 3.11 or 3.12.
• No database, no server, no .env file — the CLI is stateless and takes everything (hub URL, API keys, key paths) as command-line flags.

Installation

python3 -m venv .venv && source .venv/bin/activate   # optional but recommended
pip install tenaxisos-sdk
tenaxis --help

Install optional extras only when needed:

pip install "tenaxisos-sdk[langchain]"   # LangChain agent adapter
pip install "tenaxisos-sdk[mcp]"         # run MCP servers as real stdio processes

For local development against this checkout, use an editable install:

pip install -e ".[dev,mcp,langchain]"

The optional extras are kept separate so the base SDK never requires heavy adapter-specific dependencies.

Everyday usage

tenaxis keygen                                        # once — generates an Ed25519 signing key pair
tenaxis validate <manifest.json>                       # schema + structural validation
tenaxis test <manifest.json>                           # runs the package's declared tests
tenaxis build <manifest-dir> --out <out.package.json>  # produces a distributable package artifact
tenaxis sign <manifest.json> --key <private-key-path>  # signing ceremony (human-reviewed, not run in CI)
tenaxis verify <manifest.json> --pubkey <public-key-b64> [--require]
tenaxis publish <manifest.json> --hub <hub-url> --api-key <publisher-api-key>
tenaxis import <n8n-export.json> --out <package-dir>   # n8n → native workflow package

tenaxis keygen writes your private signing key to disk (permissions locked to owner-only) — keep it out of version control and treat it like any other private key material; the CLI never transmits or stores it for you.

Tests

pip install -e ".[dev]"
pytest tests/ -v
ruff check src/ tests/

License

MIT — see LICENSE.