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
