simthinkd 0.2.0__tar.gz → 0.2.1__tar.gz

{simthinkd-0.2.0/src/simthinkd.egg-info → simthinkd-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simthinkd
-Version: 0.2.0
+Version: 0.2.1
 Summary: A 265k-parameter decision model that picks one action in about 2 ms on one CPU core, inside real-time loops.
 Author: Myeongseongsimjae AX Institute
 License: Apache-2.0
@@ -28,7 +28,7 @@ Requires-Dist: onnx>=1.15; extra == "onnx"
 Requires-Dist: onnxruntime>=1.17; extra == "onnx"
 Dynamic: license-file
 
-<p align="center"><img src="assets/banner.png" alt="SimThink D: a tiny decision model that runs on one CPU core" width="100%"></p>
+<p align="center"><img src="assets/banner_v2.png" alt="SimThink D: a local backup for cloud decisions" width="100%"></p>
 
 <p align="center">
   <a href="https://pypi.org/project/simthinkd/"><img src="https://img.shields.io/pypi/v/simthinkd" alt="PyPI"></a>
@@ -39,27 +39,23 @@ Dynamic: license-file
   <a href="https://doi.org/10.5281/zenodo.23111615"><img src="https://zenodo.org/badge/DOI/10.5281/zenodo.23111615.svg" alt="DOI"></a>
 </p>
 
-<p align="center"><a href="https://mssj-ai-org.github.io/simthinkd/"><b>Project page, live demo and video →</b></a></p>
+<p align="center"><b>Network down. Decisions stay local.</b></p>
 
-**A tiny decision model that runs on one CPU core.** It has 265,665 parameters. It picks one action in about 2 ms. That is fast enough to decide inside every tick of a game or a control loop. No GPU is needed, not even for training.
+SimThink D is a small CPU model for offline backup decisions.
+It has 265,665 parameters and takes about 2 ms per decision on one CPU core.
 
-<p align="center">
-  <img src="assets/side_by_side.gif" alt="Same Doom game, same seed, same CPU. Left: SimThink D answers every tick. Right: a 421M-parameter general decision model, used as published, misses most ticks while it thinks." width="100%" />
-</p>
-
-<p align="center"><sub>Same game, same seed, same 6-core CPU. Left: SimThink D, 1.9 ms per decision, 1 of 420 ticks missed. Right: Laya, a 421M-parameter open decision model, used as published without training on this game. It takes about 360 ms per decision and misses 390 of 420 ticks. A dark frame means the game moved on before the decider answered.</sub></p>
+In the factory simulation, the internet was cut for 15 seconds.
+The local backup got 59 of 63 parts right, with no late decisions.
 
-<div align="center">
+<p align="center"><a href="assets/factory_fallback.mp4"><img src="assets/factory_fallback_poster.jpg" alt="Watch the factory simulation: local backup during a network outage" width="100%"></a></p>
 
-[Open in Colab](https://colab.research.google.com/github/MSSJ-AI-ORG/simthinkd/blob/main/notebooks/quickstart.ipynb) · [Try it in your browser](https://mssj-ai-org.github.io/simthinkd/#demo) · [Gradio demo](space/) · [Factory twin](examples/factory_twin/) · [Paper](docs/PAPER.md) · [Reproduce the paper](docs/REPRODUCE.md) · [Figures](docs/FIGURES.md) · [Protocol](docs/PROTOCOL.md)
+<p align="center"><a href="https://mssj-ai-org.github.io/simthinkd/#demo">Try in your browser</a> · <a href="assets/factory_fallback.mp4">Watch the video (72 s)</a> · <a href="examples/factory_twin/">Factory code</a> · <a href="docs/PAPER.md">Paper</a></p>
 
-</div>
-
-### Video: the internet goes down, the line keeps going
-
-<a href="assets/factory_fallback.mp4"><img src="assets/factory_fallback_poster.jpg" alt="Internet down. The line kept going." width="100%"></a>
+```bash
+pip install simthinkd
+```
 
-A cloud decision service runs a simulated inspection line, with SimThink D on the factory PC as its backup. When an answer does not come back in time, or the network is cut, SimThink D makes the decision. [Watch the video](assets/factory_fallback.mp4) (72 s) or see it [on LinkedIn](https://www.linkedin.com/feed/update/urn:li:activity:7510142949981057024/). The simulator is in [examples/factory_twin](examples/factory_twin/).
+What makes the next decision when your network goes down?
 
 ## Words used here
 
@@ -181,6 +177,12 @@ The second line measures any server that accepts the [decision request](docs/PRO
 
 ## Same CPU, same states
 
+<p align="center">
+  <img src="assets/side_by_side.gif" alt="Same Doom game, same seed, same CPU. Left: SimThink D answers every tick. Right: a 421M-parameter general decision model, used as published, misses most ticks while it thinks." width="100%" />
+</p>
+
+<p align="center"><sub>Same game, same seed, same 6-core CPU. Left: SimThink D, 1.9 ms per decision, 1 of 420 ticks missed. Right: Laya, a 421M-parameter open decision model, used as published without training on this game. It takes about 360 ms per decision and misses 390 of 420 ticks. A dark frame means the game moved on before the decider answered.</sub></p>
+
 **Read this first.** Laya is a general model and was not trained on this game. Its published speed, about 33 ms per question, is on a GPU. We only had a CPU. So this table compares time inside a real-time loop. It does not compare overall quality.
 
 We used one workstation CPU (6 threads) and 1,050 Doom states, then 10 live games on the same seeds. "Missed ticks" are ticks that passed before the decider answered.
@@ -200,6 +202,7 @@ SimThink D only knows what its teacher knows. It does not reason, read long text
 | Unity / C# | [docs/INTEGRATION_UNITY.md](docs/INTEGRATION_UNITY.md): a client loop that keeps the game running while it waits |
 | Browser | [web/](web/): the same model in plain JavaScript, no server |
 | A factory line (simulator) | [examples/factory_twin/](examples/factory_twin/): an inspection conveyor with a 400 ms deadline per part |
+| Gradio | [space/](space/): a small web demo you can run locally or on Hugging Face Spaces |
 | MCP (Claude Desktop, Cursor and others) | `pip install "simthinkd[mcp]"`, then `python -m simthinkd.integrations.mcp_server` |
 | LangChain / LangGraph | `from simthinkd.integrations.langchain_tool import simthinkd_tool` |
 
@@ -218,6 +221,13 @@ SimThink D only knows what its teacher knows. It does not reason, read long text
 - Probabilities are calibrated for the decider's own task only.
 - A score model returns one number. It gives no probability or error bar with it.
 
+## More
+
+- [Figures from the paper](docs/FIGURES.md)
+- [What you can reproduce](docs/REPRODUCE.md)
+- [Decision request format](docs/PROTOCOL.md)
+- [The factory video on LinkedIn](https://www.linkedin.com/feed/update/urn:li:activity:7510142949981057024/)
+
 ## Citation
 
 If you use SimThink D, please cite it with [CITATION.cff](CITATION.cff). GitHub shows a "Cite this repository" button for it.

{simthinkd-0.2.0 → simthinkd-0.2.1}/README.md

@@ -1,4 +1,4 @@
-<p align="center"><img src="assets/banner.png" alt="SimThink D: a tiny decision model that runs on one CPU core" width="100%"></p>
+<p align="center"><img src="assets/banner_v2.png" alt="SimThink D: a local backup for cloud decisions" width="100%"></p>
 
 <p align="center">
   <a href="https://pypi.org/project/simthinkd/"><img src="https://img.shields.io/pypi/v/simthinkd" alt="PyPI"></a>
@@ -9,27 +9,23 @@
   <a href="https://doi.org/10.5281/zenodo.23111615"><img src="https://zenodo.org/badge/DOI/10.5281/zenodo.23111615.svg" alt="DOI"></a>
 </p>
 
-<p align="center"><a href="https://mssj-ai-org.github.io/simthinkd/"><b>Project page, live demo and video →</b></a></p>
+<p align="center"><b>Network down. Decisions stay local.</b></p>
 
-**A tiny decision model that runs on one CPU core.** It has 265,665 parameters. It picks one action in about 2 ms. That is fast enough to decide inside every tick of a game or a control loop. No GPU is needed, not even for training.
+SimThink D is a small CPU model for offline backup decisions.
+It has 265,665 parameters and takes about 2 ms per decision on one CPU core.
 
-<p align="center">
-  <img src="assets/side_by_side.gif" alt="Same Doom game, same seed, same CPU. Left: SimThink D answers every tick. Right: a 421M-parameter general decision model, used as published, misses most ticks while it thinks." width="100%" />
-</p>
-
-<p align="center"><sub>Same game, same seed, same 6-core CPU. Left: SimThink D, 1.9 ms per decision, 1 of 420 ticks missed. Right: Laya, a 421M-parameter open decision model, used as published without training on this game. It takes about 360 ms per decision and misses 390 of 420 ticks. A dark frame means the game moved on before the decider answered.</sub></p>
+In the factory simulation, the internet was cut for 15 seconds.
+The local backup got 59 of 63 parts right, with no late decisions.
 
-<div align="center">
+<p align="center"><a href="assets/factory_fallback.mp4"><img src="assets/factory_fallback_poster.jpg" alt="Watch the factory simulation: local backup during a network outage" width="100%"></a></p>
 
-[Open in Colab](https://colab.research.google.com/github/MSSJ-AI-ORG/simthinkd/blob/main/notebooks/quickstart.ipynb) · [Try it in your browser](https://mssj-ai-org.github.io/simthinkd/#demo) · [Gradio demo](space/) · [Factory twin](examples/factory_twin/) · [Paper](docs/PAPER.md) · [Reproduce the paper](docs/REPRODUCE.md) · [Figures](docs/FIGURES.md) · [Protocol](docs/PROTOCOL.md)
+<p align="center"><a href="https://mssj-ai-org.github.io/simthinkd/#demo">Try in your browser</a> · <a href="assets/factory_fallback.mp4">Watch the video (72 s)</a> · <a href="examples/factory_twin/">Factory code</a> · <a href="docs/PAPER.md">Paper</a></p>
 
-</div>
-
-### Video: the internet goes down, the line keeps going
-
-<a href="assets/factory_fallback.mp4"><img src="assets/factory_fallback_poster.jpg" alt="Internet down. The line kept going." width="100%"></a>
+```bash
+pip install simthinkd
+```
 
-A cloud decision service runs a simulated inspection line, with SimThink D on the factory PC as its backup. When an answer does not come back in time, or the network is cut, SimThink D makes the decision. [Watch the video](assets/factory_fallback.mp4) (72 s) or see it [on LinkedIn](https://www.linkedin.com/feed/update/urn:li:activity:7510142949981057024/). The simulator is in [examples/factory_twin](examples/factory_twin/).
+What makes the next decision when your network goes down?
 
 ## Words used here
 
@@ -151,6 +147,12 @@ The second line measures any server that accepts the [decision request](docs/PRO
 
 ## Same CPU, same states
 
+<p align="center">
+  <img src="assets/side_by_side.gif" alt="Same Doom game, same seed, same CPU. Left: SimThink D answers every tick. Right: a 421M-parameter general decision model, used as published, misses most ticks while it thinks." width="100%" />
+</p>
+
+<p align="center"><sub>Same game, same seed, same 6-core CPU. Left: SimThink D, 1.9 ms per decision, 1 of 420 ticks missed. Right: Laya, a 421M-parameter open decision model, used as published without training on this game. It takes about 360 ms per decision and misses 390 of 420 ticks. A dark frame means the game moved on before the decider answered.</sub></p>
+
 **Read this first.** Laya is a general model and was not trained on this game. Its published speed, about 33 ms per question, is on a GPU. We only had a CPU. So this table compares time inside a real-time loop. It does not compare overall quality.
 
 We used one workstation CPU (6 threads) and 1,050 Doom states, then 10 live games on the same seeds. "Missed ticks" are ticks that passed before the decider answered.
@@ -170,6 +172,7 @@ SimThink D only knows what its teacher knows. It does not reason, read long text
 | Unity / C# | [docs/INTEGRATION_UNITY.md](docs/INTEGRATION_UNITY.md): a client loop that keeps the game running while it waits |
 | Browser | [web/](web/): the same model in plain JavaScript, no server |
 | A factory line (simulator) | [examples/factory_twin/](examples/factory_twin/): an inspection conveyor with a 400 ms deadline per part |
+| Gradio | [space/](space/): a small web demo you can run locally or on Hugging Face Spaces |
 | MCP (Claude Desktop, Cursor and others) | `pip install "simthinkd[mcp]"`, then `python -m simthinkd.integrations.mcp_server` |
 | LangChain / LangGraph | `from simthinkd.integrations.langchain_tool import simthinkd_tool` |
 
@@ -188,6 +191,13 @@ SimThink D only knows what its teacher knows. It does not reason, read long text
 - Probabilities are calibrated for the decider's own task only.
 - A score model returns one number. It gives no probability or error bar with it.
 
+## More
+
+- [Figures from the paper](docs/FIGURES.md)
+- [What you can reproduce](docs/REPRODUCE.md)
+- [Decision request format](docs/PROTOCOL.md)
+- [The factory video on LinkedIn](https://www.linkedin.com/feed/update/urn:li:activity:7510142949981057024/)
+
 ## Citation
 
 If you use SimThink D, please cite it with [CITATION.cff](CITATION.cff). GitHub shows a "Cite this repository" button for it.

{simthinkd-0.2.0 → simthinkd-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "simthinkd"
-version = "0.2.0"
+version = "0.2.1"
 description = "A 265k-parameter decision model that picks one action in about 2 ms on one CPU core, inside real-time loops."
 readme = "README.md"
 requires-python = ">=3.10"

{simthinkd-0.2.0 → simthinkd-0.2.1}/src/simthinkd/__init__.py

@@ -6,7 +6,7 @@
 from .core import Decider, Decision, available, build_request
 from .score import Score, Scorer
 
-__version__ = '0.2.0'
+__version__ = '0.2.1'
 __all__ = ['Decider', 'Decision', 'Score', 'Scorer', 'available', 'build_request', 'fit', 'fit_score', '__version__']
 
 

{simthinkd-0.2.0 → simthinkd-0.2.1}/src/simthinkd/server.py

@@ -5,6 +5,7 @@
 Binds to 127.0.0.1 by default. `--delay-ms` adds a fixed wait after inference (latency-injection experiments).
 """
 import json
+import socket
 import time
 from datetime import datetime, timezone
 from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
@@ -52,9 +53,23 @@ def make_handler(decider, name, delay_ms):
     return Handler
 
 
+class NoDelayHTTPServer(ThreadingHTTPServer):
+    """Turns off Nagle's algorithm on every connection.
+
+    The handler writes the headers and the body separately. On a kept-alive connection the second small write waits
+    for the client's delayed ACK, so every answer took about 40 ms (measured 2026-10-03: median 42 ms kept-alive vs
+    1.4 ms with TCP_NODELAY). Clients that reuse connections (Java HttpURLConnection does) missed 30 ms deadlines.
+    """
+
+    def get_request(self):
+        sock, addr = super().get_request()
+        sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)
+        return sock, addr
+
+
 def serve(decider='doom-defend', host='127.0.0.1', port=11890, delay_ms=0.0, name=None):
     decider = decider if isinstance(decider, Decider) else Decider(decider)
     name = name or f'simthink-d:{decider.preset["name"]}'
-    server = ThreadingHTTPServer((host, port), make_handler(decider, name, delay_ms))
+    server = NoDelayHTTPServer((host, port), make_handler(decider, name, delay_ms))
     print(json.dumps({'listening': f'{host}:{port}', 'weights_sha256': decider.sha256, 'model': name}), flush=True)
     server.serve_forever()

{simthinkd-0.2.0 → simthinkd-0.2.1/src/simthinkd.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simthinkd
-Version: 0.2.0
+Version: 0.2.1
 Summary: A 265k-parameter decision model that picks one action in about 2 ms on one CPU core, inside real-time loops.
 Author: Myeongseongsimjae AX Institute
 License: Apache-2.0
@@ -28,7 +28,7 @@ Requires-Dist: onnx>=1.15; extra == "onnx"
 Requires-Dist: onnxruntime>=1.17; extra == "onnx"
 Dynamic: license-file
 
-<p align="center"><img src="assets/banner.png" alt="SimThink D: a tiny decision model that runs on one CPU core" width="100%"></p>
+<p align="center"><img src="assets/banner_v2.png" alt="SimThink D: a local backup for cloud decisions" width="100%"></p>
 
 <p align="center">
   <a href="https://pypi.org/project/simthinkd/"><img src="https://img.shields.io/pypi/v/simthinkd" alt="PyPI"></a>
@@ -39,27 +39,23 @@ Dynamic: license-file
   <a href="https://doi.org/10.5281/zenodo.23111615"><img src="https://zenodo.org/badge/DOI/10.5281/zenodo.23111615.svg" alt="DOI"></a>
 </p>
 
-<p align="center"><a href="https://mssj-ai-org.github.io/simthinkd/"><b>Project page, live demo and video →</b></a></p>
+<p align="center"><b>Network down. Decisions stay local.</b></p>
 
-**A tiny decision model that runs on one CPU core.** It has 265,665 parameters. It picks one action in about 2 ms. That is fast enough to decide inside every tick of a game or a control loop. No GPU is needed, not even for training.
+SimThink D is a small CPU model for offline backup decisions.
+It has 265,665 parameters and takes about 2 ms per decision on one CPU core.
 
-<p align="center">
-  <img src="assets/side_by_side.gif" alt="Same Doom game, same seed, same CPU. Left: SimThink D answers every tick. Right: a 421M-parameter general decision model, used as published, misses most ticks while it thinks." width="100%" />
-</p>
-
-<p align="center"><sub>Same game, same seed, same 6-core CPU. Left: SimThink D, 1.9 ms per decision, 1 of 420 ticks missed. Right: Laya, a 421M-parameter open decision model, used as published without training on this game. It takes about 360 ms per decision and misses 390 of 420 ticks. A dark frame means the game moved on before the decider answered.</sub></p>
+In the factory simulation, the internet was cut for 15 seconds.
+The local backup got 59 of 63 parts right, with no late decisions.
 
-<div align="center">
+<p align="center"><a href="assets/factory_fallback.mp4"><img src="assets/factory_fallback_poster.jpg" alt="Watch the factory simulation: local backup during a network outage" width="100%"></a></p>
 
-[Open in Colab](https://colab.research.google.com/github/MSSJ-AI-ORG/simthinkd/blob/main/notebooks/quickstart.ipynb) · [Try it in your browser](https://mssj-ai-org.github.io/simthinkd/#demo) · [Gradio demo](space/) · [Factory twin](examples/factory_twin/) · [Paper](docs/PAPER.md) · [Reproduce the paper](docs/REPRODUCE.md) · [Figures](docs/FIGURES.md) · [Protocol](docs/PROTOCOL.md)
+<p align="center"><a href="https://mssj-ai-org.github.io/simthinkd/#demo">Try in your browser</a> · <a href="assets/factory_fallback.mp4">Watch the video (72 s)</a> · <a href="examples/factory_twin/">Factory code</a> · <a href="docs/PAPER.md">Paper</a></p>
 
-</div>
-
-### Video: the internet goes down, the line keeps going
-
-<a href="assets/factory_fallback.mp4"><img src="assets/factory_fallback_poster.jpg" alt="Internet down. The line kept going." width="100%"></a>
+```bash
+pip install simthinkd
+```
 
-A cloud decision service runs a simulated inspection line, with SimThink D on the factory PC as its backup. When an answer does not come back in time, or the network is cut, SimThink D makes the decision. [Watch the video](assets/factory_fallback.mp4) (72 s) or see it [on LinkedIn](https://www.linkedin.com/feed/update/urn:li:activity:7510142949981057024/). The simulator is in [examples/factory_twin](examples/factory_twin/).
+What makes the next decision when your network goes down?
 
 ## Words used here
 
@@ -181,6 +177,12 @@ The second line measures any server that accepts the [decision request](docs/PRO
 
 ## Same CPU, same states
 
+<p align="center">
+  <img src="assets/side_by_side.gif" alt="Same Doom game, same seed, same CPU. Left: SimThink D answers every tick. Right: a 421M-parameter general decision model, used as published, misses most ticks while it thinks." width="100%" />
+</p>
+
+<p align="center"><sub>Same game, same seed, same 6-core CPU. Left: SimThink D, 1.9 ms per decision, 1 of 420 ticks missed. Right: Laya, a 421M-parameter open decision model, used as published without training on this game. It takes about 360 ms per decision and misses 390 of 420 ticks. A dark frame means the game moved on before the decider answered.</sub></p>
+
 **Read this first.** Laya is a general model and was not trained on this game. Its published speed, about 33 ms per question, is on a GPU. We only had a CPU. So this table compares time inside a real-time loop. It does not compare overall quality.
 
 We used one workstation CPU (6 threads) and 1,050 Doom states, then 10 live games on the same seeds. "Missed ticks" are ticks that passed before the decider answered.
@@ -200,6 +202,7 @@ SimThink D only knows what its teacher knows. It does not reason, read long text
 | Unity / C# | [docs/INTEGRATION_UNITY.md](docs/INTEGRATION_UNITY.md): a client loop that keeps the game running while it waits |
 | Browser | [web/](web/): the same model in plain JavaScript, no server |
 | A factory line (simulator) | [examples/factory_twin/](examples/factory_twin/): an inspection conveyor with a 400 ms deadline per part |
+| Gradio | [space/](space/): a small web demo you can run locally or on Hugging Face Spaces |
 | MCP (Claude Desktop, Cursor and others) | `pip install "simthinkd[mcp]"`, then `python -m simthinkd.integrations.mcp_server` |
 | LangChain / LangGraph | `from simthinkd.integrations.langchain_tool import simthinkd_tool` |
 
@@ -218,6 +221,13 @@ SimThink D only knows what its teacher knows. It does not reason, read long text
 - Probabilities are calibrated for the decider's own task only.
 - A score model returns one number. It gives no probability or error bar with it.
 
+## More
+
+- [Figures from the paper](docs/FIGURES.md)
+- [What you can reproduce](docs/REPRODUCE.md)
+- [Decision request format](docs/PROTOCOL.md)
+- [The factory video on LinkedIn](https://www.linkedin.com/feed/update/urn:li:activity:7510142949981057024/)
+
 ## Citation
 
 If you use SimThink D, please cite it with [CITATION.cff](CITATION.cff). GitHub shows a "Cite this repository" button for it.

{simthinkd-0.2.0 → simthinkd-0.2.1}/src/simthinkd.egg-info/SOURCES.txt

@@ -28,6 +28,7 @@ tests/test_factory_twin.py
 tests/test_notebook.py
 tests/test_package.py
 tests/test_score.py
+tests/test_server_latency.py
 tests/test_space.py
 tests/test_web_page.py
 tests/test_web_parity.py

simthinkd-0.2.1/tests/test_server_latency.py

@@ -0,0 +1,30 @@
+"""The HTTP server must answer fast on a kept-alive connection (regression: ~40 ms Nagle/delayed-ACK stall in 0.2.0)."""
+import http.client
+import statistics
+import threading
+import time
+
+from simthinkd.core import Decider
+from simthinkd.server import NoDelayHTTPServer, make_handler
+
+
+def test_keep_alive_answers_fast():
+    decider = Decider('doom-defend')
+    server = NoDelayHTTPServer(('127.0.0.1', 0), make_handler(decider, 'test', 0.0))
+    threading.Thread(target=server.serve_forever, daemon=True).start()
+    try:
+        conn = http.client.HTTPConnection('127.0.0.1', server.server_address[1], timeout=2)
+        times = []
+        for _ in range(30):
+            start = time.perf_counter()
+            conn.request('GET', '/health')
+            conn.getresponse().read()
+            times.append((time.perf_counter() - start) * 1000)
+        assert statistics.median(times) < 20, times
+    finally:
+        server.shutdown()
+
+
+if __name__ == "__main__":
+    test_keep_alive_answers_fast()
+    print("server latency test passed")