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
Release files for noeta-sdk 0.6.28
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| noeta_sdk-0.6.28.tar.gz | 518.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| noeta_sdk-0.6.28-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.1 MB
Release files / noeta_sdk-0.6.28.tar.gz
| Download URL | noeta_sdk-0.6.28.tar.gz |
|---|---|
| Size | 518.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
729f7b341add0e73a309a95e5cde9d951f873d60974e4ebf1bc6882d670bdda6
|
|
BLAKE2b-256 checksum How to use checksums |
338ce3beb2400758c1540d2141c7a9354c5c26315b5df81a152b5ee84244dd70
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","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}
|
Release files / noeta_sdk-0.6.28-py3-none-any.whl
| Download URL | noeta_sdk-0.6.28-py3-none-any.whl |
|---|---|
| Size | 623.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
31af41eaf05642ac9dc72f24e6e42dc12f3be41b575afa1c6f6bee5c1ced7ccd
|
|
BLAKE2b-256 checksum How to use checksums |
00e07d5edb6ba6177f8122f3aa3fa5a5ac61c12e8ce800d4a97183da2d167fb9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","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}
|
