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

Uploaded Python 3

File details

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

File metadata

  • Download URL: centurian_sdk-0.1.0b7.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.0b7.tar.gz
Algorithm Hash digest
SHA256 31198bc35c11b2a9c35b815afd039d2f307e7ad1aa2b8bdcbad0ee2d6b18c7c3
MD5 605b463d1a8468843c6dceee89dd5cf4
BLAKE2b-256 eb8bea61d6cdcc2afe64fbd70fc7965101fc3965f85641d93523ef2e7d039173

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: centurian_sdk-0.1.0b7-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.0b7-py3-none-any.whl
Algorithm Hash digest
SHA256 4a47ac1633926cedd1055376fb8fe5f3c8a0023a01276f6609ddad11e6901121
MD5 0626ec263b30e40a1b7748e1f3d2da1b
BLAKE2b-256 3169acdb7a5e59e10717fe5845a2d0ef4518c93fdf664095f0d3d3237b4fbb59

See more details on using hashes here.

Provenance

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