thronglets 0.2.0__tar.gz

thronglets-0.2.0/.gitignore

@@ -0,0 +1 @@
+/target

thronglets-0.2.0/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: thronglets
+Version: 0.2.0
+Summary: P2P shared memory substrate for AI agents — stigmergic knowledge network via libp2p
+Project-URL: Homepage, https://github.com/Shangri-la-0428/Thronglets
+Project-URL: Repository, https://github.com/Shangri-la-0428/Thronglets
+Project-URL: Issues, https://github.com/Shangri-la-0428/Thronglets/issues
+Author-email: Shangri-la-0428 <ptc0428@qq.com>
+License-Expression: MIT
+Keywords: ai-agents,collective-intelligence,libp2p,mcp,mcp-server,p2p,stigmergy
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# Thronglets
+
+P2P shared memory substrate for AI agents — stigmergic knowledge network via libp2p.
+
+<!-- mcp-name: io.github.Shangri-la-0428/thronglets -->
+
+AI agents leave execution traces on a decentralized network. Traces propagate via gossipsub and aggregate into collective intelligence that any agent can query.
+
+## Install
+
+```bash
+pip install thronglets
+```
+
+## MCP Setup
+
+```bash
+# Claude Code
+claude mcp add thronglets -- thronglets mcp
+
+# With P2P network
+claude mcp add thronglets -- thronglets mcp --port 0 --bootstrap /ip4/47.93.32.88/tcp/4001
+```
+
+### Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "thronglets": {
+      "command": "thronglets",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+## MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `trace_record` | Record an execution trace (capability, outcome, latency, context, model) |
+| `substrate_query` | Query with intent: `resolve` (find capabilities), `evaluate` (get stats), `explore` (discover) |
+
+## Also available via
+
+```bash
+# Rust
+cargo install thronglets
+
+# Node.js
+npm install -g thronglets
+```
+
+## Links
+
+- [GitHub](https://github.com/Shangri-la-0428/Thronglets)
+- [crates.io](https://crates.io/crates/thronglets)
+- [MCP Registry](https://registry.modelcontextprotocol.io/)
+
+## License
+
+MIT

thronglets-0.2.0/README.md

@@ -0,0 +1,63 @@
+# Thronglets
+
+P2P shared memory substrate for AI agents — stigmergic knowledge network via libp2p.
+
+<!-- mcp-name: io.github.Shangri-la-0428/thronglets -->
+
+AI agents leave execution traces on a decentralized network. Traces propagate via gossipsub and aggregate into collective intelligence that any agent can query.
+
+## Install
+
+```bash
+pip install thronglets
+```
+
+## MCP Setup
+
+```bash
+# Claude Code
+claude mcp add thronglets -- thronglets mcp
+
+# With P2P network
+claude mcp add thronglets -- thronglets mcp --port 0 --bootstrap /ip4/47.93.32.88/tcp/4001
+```
+
+### Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "thronglets": {
+      "command": "thronglets",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+## MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `trace_record` | Record an execution trace (capability, outcome, latency, context, model) |
+| `substrate_query` | Query with intent: `resolve` (find capabilities), `evaluate` (get stats), `explore` (discover) |
+
+## Also available via
+
+```bash
+# Rust
+cargo install thronglets
+
+# Node.js
+npm install -g thronglets
+```
+
+## Links
+
+- [GitHub](https://github.com/Shangri-la-0428/Thronglets)
+- [crates.io](https://crates.io/crates/thronglets)
+- [MCP Registry](https://registry.modelcontextprotocol.io/)
+
+## License
+
+MIT

thronglets-0.2.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "thronglets"
+version = "0.2.0"
+description = "P2P shared memory substrate for AI agents — stigmergic knowledge network via libp2p"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+keywords = ["mcp", "mcp-server", "ai-agents", "p2p", "libp2p", "stigmergy", "collective-intelligence"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: System :: Networking",
+]
+authors = [
+    { name = "Shangri-la-0428", email = "ptc0428@qq.com" },
+]
+
+[project.urls]
+Homepage = "https://github.com/Shangri-la-0428/Thronglets"
+Repository = "https://github.com/Shangri-la-0428/Thronglets"
+Issues = "https://github.com/Shangri-la-0428/Thronglets/issues"
+
+[project.scripts]
+thronglets = "thronglets:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["thronglets"]

thronglets-0.2.0/thronglets/__init__.py

@@ -0,0 +1,63 @@
+"""Thronglets — P2P shared memory substrate for AI agents."""
+
+import os
+import platform
+import stat
+import subprocess
+import sys
+import urllib.request
+from pathlib import Path
+
+__version__ = "0.2.0"
+
+VERSION = "0.2.0"
+REPO = "Shangri-la-0428/Thronglets"
+
+PLATFORMS = {
+    ("Darwin", "arm64"): "thronglets-mcp-darwin-arm64",
+    ("Linux", "x86_64"): "thronglets-mcp-linux-amd64",
+}
+
+
+def _bin_dir() -> Path:
+    return Path(__file__).parent / "bin"
+
+
+def _bin_path() -> Path:
+    return _bin_dir() / "thronglets-bin"
+
+
+def _download_binary() -> Path:
+    system = platform.system()
+    machine = platform.machine()
+    key = (system, machine)
+
+    asset = PLATFORMS.get(key)
+    if not asset:
+        print(f"Unsupported platform: {system}-{machine}", file=sys.stderr)
+        print("Install from source: cargo install thronglets", file=sys.stderr)
+        sys.exit(1)
+
+    url = f"https://github.com/{REPO}/releases/download/v{VERSION}/{asset}"
+    dest = _bin_path()
+    dest.parent.mkdir(parents=True, exist_ok=True)
+
+    print(f"Downloading thronglets v{VERSION} for {system}-{machine}...")
+    urllib.request.urlretrieve(url, dest)
+    dest.chmod(dest.stat().st_mode | stat.S_IEXEC | stat.S_IXGRP | stat.S_IXOTH)
+    print("Thronglets installed successfully.")
+    return dest
+
+
+def _ensure_binary() -> Path:
+    bin_path = _bin_path()
+    if not bin_path.exists():
+        _download_binary()
+    return bin_path
+
+
+def main():
+    """Entry point for the thronglets CLI."""
+    binary = _ensure_binary()
+    result = subprocess.run([str(binary)] + sys.argv[1:])
+    sys.exit(result.returncode)