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

Uploaded Python 3

File details

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

File metadata

  • Download URL: centurian_sdk-0.1.0b5.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.0b5.tar.gz
Algorithm Hash digest
SHA256 4d93916e2a28fa459107205cbf6a418c88f5d5a006784cf837f974b348a419b0
MD5 cbe5581dd4836d9c59eefb8241a7d280
BLAKE2b-256 984dcbc4596f554a310305dafaa94b27c82f04e014bb711d38c77c3369efb342

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: centurian_sdk-0.1.0b5-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.0b5-py3-none-any.whl
Algorithm Hash digest
SHA256 752d08632f9e98aa887c8c200b9a3b85e135b6ce73d0d158e75576aacce57a81
MD5 58e0fad72db113fba5a8c0d1072c480b
BLAKE2b-256 24e125f1cc80446f3bfab1b9264375d581c68b1df08afb9af15f3f1c0b07dd0f

See more details on using hashes here.

Provenance

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