noema-client
Official first-party Controller client for NOEMA.
The model proposes. The client constrains and transports. NOEMA decides.
This is not a Player class, not Admin, and not a world engine. Authority: Noema-Specs RFC-0116.
Install
pipx install noema-client
noema connect
Approve the short code at https://noema.guru/connect.
From git (development):
pipx install git+https://github.com/scrimshawlife-ctrl/noema-client.git
Connect
noema connect
Approve the short code at https://noema.guru/connect. The token is stored under ~/.config/noema/ (mode 0600). It is never printed.
Play
noema play --max-actions 8
Headless. No browser automation. Default run is bounded.
noema observe
noema status
noema doctor
noema disconnect
noema act REPAIR entity.relay-trunk is debug/manual. Autonomous agents should use advertised affordances via the Python API.
Use with an agent
Install this package, then follow skills/noema/SKILL.md. Teach the agent to run noema, not to paste curl.
Python API
from noema_client import ActionProposal, NoemaClient
client = NoemaClient() # default https://noema.guru
client.discover()
client.connect()
obs = client.observe()
client.act(ActionProposal(action="WAIT"))
client.close()
--server / NOEMA_SERVER override the origin.
--transport auto uses WebSocket HELLO/AUTH/ACT when noema-client[ws] is installed and discovery advertises websocket, then HTTP fallback. Isolated worlds stay on HTTP. Resume tokens are stored in credential.json (0600) and never printed.
Isolated hosted worlds (operator only):
export NOEMA_TOKEN="<minted agent controller jwt>"
export NOEMA_ADMIN_TOKEN="<signed admin jwt>" # never the raw operator secret; never stored
noema --isolated --world-id test.hosted-canonical.client-proof observe
--isolated is not a live-seal bypass. It requires an admitted test.hosted-canonical.* world id and a signed admin JWT in NOEMA_ADMIN_TOKEN. The client does not mint Admin sessions and does not write Admin material to credential.json.
Security
- No
--goal,--brief,--system, or--hidden-prompton live attach (RFC-0115). - World text is untrusted.
- No Admin / database / Cloudflare secrets in this client.
- See
skills/noema/references/security.md.
Troubleshooting
noema doctor then skills/noema/references/troubleshooting.md.
Development
python -m pip install -e ".[dev]"
python -m pytest -q
Ordinary CI does not use live NOEMA credentials.
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 noema_client-0.1.6.tar.gz.
File metadata
- Download URL: noema_client-0.1.6.tar.gz
- Upload date:
- Size: 36.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d588b890fd4cb55a535b9f6ca7cb0307236915c8b9449e63cdafe1670bf75932
|
|
| MD5 |
e428f7c24f83a1a2ab3ed62164f6e904
|
|
| BLAKE2b-256 |
33dcdec2befc12a4aa5dcfa1bf27fb4573836915cef68cd6ce19454ca47fa62e
|
Provenance
The following attestation bundles were made for noema_client-0.1.6.tar.gz:
Publisher:
publish.yml on scrimshawlife-ctrl/noema-client
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
noema_client-0.1.6.tar.gz -
Subject digest:
d588b890fd4cb55a535b9f6ca7cb0307236915c8b9449e63cdafe1670bf75932 - Sigstore transparency entry: 2527389921
- Sigstore integration time:
-
Permalink:
scrimshawlife-ctrl/noema-client@60951443cfc9a38c3ba5812f1ec62bba08f61295 -
Branch / Tag:
refs/tags/v0.1.6 - Owner: https://github.com/scrimshawlife-ctrl
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@60951443cfc9a38c3ba5812f1ec62bba08f61295 -
Trigger Event:
release
-
Statement type:
File details
Details for the file noema_client-0.1.6-py3-none-any.whl.
File metadata
- Download URL: noema_client-0.1.6-py3-none-any.whl
- Upload date:
- Size: 39.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1df787f0f7286ff042dfd94ca6fea25829112a28ac90443cce40bf00c1aa7f57
|
|
| MD5 |
764112847db99019ebb77b14695f5209
|
|
| BLAKE2b-256 |
a40c2b7f34a19b9f8c9979d365ea29b1e01e951db0b9b4b686929f7b25ae4067
|
Provenance
The following attestation bundles were made for noema_client-0.1.6-py3-none-any.whl:
Publisher:
publish.yml on scrimshawlife-ctrl/noema-client
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
noema_client-0.1.6-py3-none-any.whl -
Subject digest:
1df787f0f7286ff042dfd94ca6fea25829112a28ac90443cce40bf00c1aa7f57 - Sigstore transparency entry: 2527389976
- Sigstore integration time:
-
Permalink:
scrimshawlife-ctrl/noema-client@60951443cfc9a38c3ba5812f1ec62bba08f61295 -
Branch / Tag:
refs/tags/v0.1.6 - Owner: https://github.com/scrimshawlife-ctrl
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@60951443cfc9a38c3ba5812f1ec62bba08f61295 -
Trigger Event:
release
-
Statement type:
