Skip to main content

Centurian Python SDK — thin MCP wrapper for AI agents. Auto-registers, instruments tool calls, attributes cost. Implements ADR-017 SDK perf primitives: local rule cache + per-action OPA decision cache + durable sqlite-backed event queue + async batched MCP calls. Owner: Connect agent (T12 W3-W5).

Project description

centurian-sdk (Python)

Thin MCP wrapper for AI agents. See docs/prd/v4.1/Centurian_Solo_Developer_Experience.md.

Install (local, side-by-side with the monorepo)

pnpm does not manage Python packages. Install directly:

pip install -e ./packages/sdk-python
# or, from a template directory:
pip install -e ../../packages/sdk-python

Use

from centurian import Agent

agent = Agent(name="my-agent", purpose="Answer questions about my docs")

@agent.tool
def search_docs(query: str) -> str:
    return run_my_search(query)

agent.run()

Reads CENTURIAN_TOKEN, CENTURIAN_MCP_URL, CENTURIAN_ORG_ID, CENTURIAN_OWNER_USER_ID, CENTURIAN_QUEUE_PATH from env.

Day-1 status: real MCP calls are stubbed; the public API surface is locked so templates and customer code written today survive the T2 transport swap.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

centurian_sdk-0.1.0b4.tar.gz (17.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

centurian_sdk-0.1.0b4-py3-none-any.whl (16.2 kB view details)

Uploaded Python 3

File details

Details for the file centurian_sdk-0.1.0b4.tar.gz.

File metadata

  • Download URL: centurian_sdk-0.1.0b4.tar.gz
  • Upload date:
  • Size: 17.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for centurian_sdk-0.1.0b4.tar.gz
Algorithm Hash digest
SHA256 6643d1bf8a4a50b4d2b566820909c3145a8f658089ebf3cdcc3ae6ae401a9b44
MD5 b52eb740528cfc55f1393d4ffea7f01f
BLAKE2b-256 f0956b313bc2bf3196e3bea0b443889a5f2a8f8885ae0ed0528df5539bb6ec7e

See more details on using hashes here.

Provenance

The following attestation bundles were made for centurian_sdk-0.1.0b4.tar.gz:

Publisher: release.yml on omniviewai/Centurian

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file centurian_sdk-0.1.0b4-py3-none-any.whl.

File metadata

  • Download URL: centurian_sdk-0.1.0b4-py3-none-any.whl
  • Upload date:
  • Size: 16.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for centurian_sdk-0.1.0b4-py3-none-any.whl
Algorithm Hash digest
SHA256 4fa508a0576e352435b99e6f11674df0d1799f745ec19c5899d6cc28c9232d6e
MD5 471ae9c381379d335266a8c76d97885e
BLAKE2b-256 70ec91a7e0464e300f1f0ae24450c754532f0eb368128c450efdc0b0708cb586

See more details on using hashes here.

Provenance

The following attestation bundles were made for centurian_sdk-0.1.0b4-py3-none-any.whl:

Publisher: release.yml on omniviewai/Centurian

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page