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

Uploaded Python 3

File details

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

File metadata

  • Download URL: kcastle_agent-0.1.0a4.tar.gz
  • Upload date:
  • Size: 11.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.2 {"installer":{"name":"uv","version":"0.12.2","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.0a4.tar.gz
Algorithm Hash digest
SHA256 a7b999068cea49382bca5d0a10d5e4dabca61f80329f637c8c9d88364dfe98e1
MD5 87198b62054301bf1f18132b3947cc2b
BLAKE2b-256 5ed7d70827c818390cd0851804946fb888403a9cb6ac436f8e3fa0a57d967c3f

See more details on using hashes here.

File details

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

File metadata

  • Download URL: kcastle_agent-0.1.0a4-py3-none-any.whl
  • Upload date:
  • Size: 17.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.2 {"installer":{"name":"uv","version":"0.12.2","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.0a4-py3-none-any.whl
Algorithm Hash digest
SHA256 5c06c135d3eadbe97ede70ca8cc99a39cdac6a29269e6533d2350e79406d591d
MD5 73a57620744c21ad57a041e6bee43c2a
BLAKE2b-256 5efe2bb88d963b6386a932016c444a8aef22c8d6ddb9f18eeace9259daf5dffe

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