Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

kcastle-agent

A minimal OpenAI Responses Agent core with optional harness infrastructure.

from openai import AsyncOpenAI

from pathlib import Path

from kagent import Agent, Session

session = Session.create(Path.home() / ".kcastle" / "sessions")

agent = Agent(
    client=AsyncOpenAI(),
    model="gpt-5.6-sol",
    instructions="You are a helpful agent.",
    state=session.state,
    commit=session.commit,
)

async for event in agent.run("Hello"):
    print(event)

Agent is the brain: it owns causal State, the loop, steering, follow-ups, cancellation, events, and compaction. kagent.harness surrounds it with Session persistence, an explicit Env, and executable ToolRuntime adapters. User interfaces render events and provide approvals only. When one model response contains multiple function calls, execute_tool may run concurrently; custom executors must be safe for concurrent use.

Download files

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

Source Distribution

kcastle_agent-0.1.0a5.tar.gz (11.9 kB view details)

Uploaded Source

Built Distribution

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

kcastle_agent-0.1.0a5-py3-none-any.whl (17.1 kB view details)

Uploaded Python 3

File details

Details for the file kcastle_agent-0.1.0a5.tar.gz.

File metadata

  • Download URL: kcastle_agent-0.1.0a5.tar.gz
  • Upload date:
  • Size: 11.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for kcastle_agent-0.1.0a5.tar.gz
Algorithm Hash digest
SHA256 9a85393208e8df64e0203203f09f576e66269e7e284be16ab7758ea54d5a7afe
MD5 5cef61bc18c32cb3ea083e8409b5fd33
BLAKE2b-256 af439b776772c3643f4fc0f5b2d595499995598e3029f156471cf8531e05aa59

See more details on using hashes here.

File details

Details for the file kcastle_agent-0.1.0a5-py3-none-any.whl.

File metadata

  • Download URL: kcastle_agent-0.1.0a5-py3-none-any.whl
  • Upload date:
  • Size: 17.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for kcastle_agent-0.1.0a5-py3-none-any.whl
Algorithm Hash digest
SHA256 20156feb0cbf5e5ab894c6267308dc59e31919e8caebbd00e5e0cb128082514d
MD5 2a5a39dee11e14f202a74d7bcbe16f84
BLAKE2b-256 4160ab8b0cd9f1c4ae64f2955c3c954978516265ee535526298ea971d2e60f05

See more details on using hashes here.

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