noeta-sdk
The thin in-process client surface (noeta.sdk facade — query / Client
/ Options / tool / extension interfaces) over the
noeta-runtime kernel, plus the built-in
plugin catalogue (noeta.builtins — every official capability
implementation: the fs/web tool packs, provider adapters, guards, reminders,
memory, browser, app, MCP, sandbox backends, skills, the ReAct policy) and
the official presets. Like
claude-agent-sdk / LangChain: import noeta.sdk, run an agent in-process; no
engine internals, no HTTP server.
Part of the Noeta workspace. Apache-2.0.
Install
pip install noeta-sdk # noeta-runtime comes along as a transitive dependency
Then import noeta.sdk — that single module is the whole public surface. Python 3.11+.
Quickstart — zero credentials
No API key, no network: drive one turn with the deterministic offline provider
from noeta.sdk.testing.
import tempfile
from pathlib import Path
from noeta.sdk import Options, query, LLMResponse, TextBlock, Usage
from noeta.sdk.testing import FakeLLMProvider
provider = FakeLLMProvider(
responses=[
LLMResponse(
stop_reason="end_turn",
content=[TextBlock(text="Hello from a Noeta SDK agent!")],
usage=Usage(uncached=1, output=1),
)
]
)
with tempfile.TemporaryDirectory() as tmp:
result = query(
Options(
system_prompt="You are a concise assistant.",
allowed_tools=("read",),
permission_mode="bypassPermissions",
),
goal="Say hello.",
provider=provider,
workspace_dir=Path(tmp),
model="stub-model",
)
assert result.answer() == "Hello from a Noeta SDK agent!"
query returns the full event-envelope stream for the turn; result.answer()
reads the answer off the terminal envelope. Swap the FakeLLMProvider for a live
adapter from noeta.sdk.providers (AnthropicProvider / OpenAICompatProvider)
to connect a real model — the provider is wiring, not agent identity.
Learn more
- Runnable
examples/— a minimal agent, custom tools, an in-process MCP server, a permission gate, provider swapping, sub-agent delegation, and survivingkill -9mid-task. - Documentation — tutorials, how-to guides, and the SDK reference.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file noeta_sdk-0.6.4.tar.gz.
File metadata
- Download URL: noeta_sdk-0.6.4.tar.gz
- Upload date:
- Size: 444.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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9240e2f02653032107649511881706b7ea81752daf0db2663ba6d99e9095596b
|
|
| MD5 |
1b1f05d726a6df76258bb0ac4caa5550
|
|
| BLAKE2b-256 |
10a607388cf4903a6f50ba4b673fb0cb5eac3cfb4a3fe5c00825184d36bbb62e
|
File details
Details for the file noeta_sdk-0.6.4-py3-none-any.whl.
File metadata
- Download URL: noeta_sdk-0.6.4-py3-none-any.whl
- Upload date:
- Size: 544.2 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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
58915655846d1e405cc541a3141194eeee0ec9b352193a80d94168619c656cc7
|
|
| MD5 |
43294bd1e99e66c9800d2da4f5df8d31
|
|
| BLAKE2b-256 |
8d015417538ece042ea5253bddb84b521e2b780a6dc6c6f44cf0f792a17d496f
|
