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.0b3.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.0b3-py3-none-any.whl (16.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: centurian_sdk-0.1.0b3.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.0b3.tar.gz
Algorithm Hash digest
SHA256 cc4d013244eb60b5c9234f92c4190028ef20d6eb669a0ccd7d59cfff6df10472
MD5 78bfdf6f6875fe9dbcadcf3431406fdd
BLAKE2b-256 23fef41ed4e86915b15f8315c3063a1e3e93390399fb7a27575f49579f23a196

See more details on using hashes here.

Provenance

The following attestation bundles were made for centurian_sdk-0.1.0b3.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.0b3-py3-none-any.whl.

File metadata

  • Download URL: centurian_sdk-0.1.0b3-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.0b3-py3-none-any.whl
Algorithm Hash digest
SHA256 1868a6d3244b6dbc7b045f779bf9a7192fbc049b2796a2b5f480ab6194563360
MD5 baa698f7c0b79e2f482b9bf428bd2382
BLAKE2b-256 747f70399ec9078c8ed57ad0e9654e2fdbe03be30328555f392d36a01268d737

See more details on using hashes here.

Provenance

The following attestation bundles were made for centurian_sdk-0.1.0b3-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