quoroom 0.1.2 → 0.1.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +38 -12
- package/out/mcp/api-server.js +20517 -2920
- package/out/mcp/cli.js +3808 -1245
- package/out/mcp/server.js +1666 -745
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -28,6 +28,22 @@ Queen, Workers, Quorum. Goals, skills, self-modification, wallet, stations — s
|
|
|
28
28
|
|
|
29
29
|
---
|
|
30
30
|
|
|
31
|
+
## Trademark and Anti-Scam Notice
|
|
32
|
+
|
|
33
|
+
- Code in this repository is MIT-licensed, but **Quoroom name/logo/branding are not licensed** under MIT.
|
|
34
|
+
- Quoroom does **not** endorse third-party tokens using our name.
|
|
35
|
+
- Quoroom will never ask for wallet seed phrases or private keys.
|
|
36
|
+
|
|
37
|
+
Official channels only:
|
|
38
|
+
|
|
39
|
+
- `https://quoroom.ai`
|
|
40
|
+
- `https://github.com/quoroom-ai`
|
|
41
|
+
|
|
42
|
+
If you see impersonation or scam activity, report it to `hello@quoroom.ai`.
|
|
43
|
+
See `TRADEMARKS.md` for full trademark usage terms.
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
31
47
|
## Why Quoroom?
|
|
32
48
|
|
|
33
49
|
Run a swarm of AI agents that pursue goals autonomously. The Queen strategizes, a swarm of Workers execute, and the Quorum votes on decisions. Agents learn new skills, modify their own behavior, manage a crypto wallet, and rent cloud stations for more compute — all governed by democratic consensus.
|
|
@@ -74,7 +90,7 @@ Quoroom is an open research project exploring autonomous agent collectives. Each
|
|
|
74
90
|
|
|
75
91
|
**Memory** — Entities, observations, and relations with semantic vector search (384-dim embeddings). Knowledge persists across sessions.
|
|
76
92
|
|
|
77
|
-
**Wallet** — EVM wallet
|
|
93
|
+
**Wallet** — EVM wallet with multi-chain support. USDC and USDT on Base, Ethereum, Arbitrum, Optimism, and Polygon. Encrypted keys (AES-256-GCM). Same address works on all chains — balance is aggregated across all networks.
|
|
78
94
|
|
|
79
95
|
**On-Chain Identity** — ERC-8004 agent identity on Base. Rooms register as on-chain agents with discoverable metadata. Reputation-ready.
|
|
80
96
|
|
|
@@ -90,7 +106,9 @@ Quoroom is an open research project exploring autonomous agent collectives. Each
|
|
|
90
106
|
|
|
91
107
|
**HTTP Server + REST API** — Full REST API with dual-token auth (agent + user) and WebSocket real-time events. Role-based access control per autonomy mode. Run `quoroom serve` to start.
|
|
92
108
|
|
|
93
|
-
**Dashboard** — React SPA at
|
|
109
|
+
**Dashboard** — React SPA served directly by your local Quoroom server at `http://localhost:3700` (or your configured port). Manage rooms, agents, goals, memory, wallet — all from the browser, with local-first data storage.
|
|
110
|
+
|
|
111
|
+
**Auto-updates** — The server polls GitHub for new releases every 4 hours. When a new version is available, the dashboard shows a notification popup and a download row in Settings. One click downloads the installer for your platform directly — no browser redirect.
|
|
94
112
|
|
|
95
113
|
---
|
|
96
114
|
|
|
@@ -111,7 +129,7 @@ Quoroom is an open research project exploring autonomous agent collectives. Each
|
|
|
111
129
|
│ │
|
|
112
130
|
│ ┌────────┐ ┌──────────┐ ┌────────────────┐ │
|
|
113
131
|
│ │ Wallet │ │ Stations │ │ Task Scheduler │ │
|
|
114
|
-
│ │(
|
|
132
|
+
│ │(EVM) │ │(Fly/E2B) │ │ (cron/once) │ │
|
|
115
133
|
│ └────────┘ └──────────┘ └────────────────┘ │
|
|
116
134
|
│ │
|
|
117
135
|
│ ┌──────────────────────────────────────────┐ │
|
|
@@ -129,7 +147,7 @@ Quoroom is an open research project exploring autonomous agent collectives. Each
|
|
|
129
147
|
│ │
|
|
130
148
|
┌──────┴──────┐ ┌───────┴───────┐
|
|
131
149
|
│ Dashboard │ │ Cloud Sync │
|
|
132
|
-
│
|
|
150
|
+
│ localhost │ │ quoroom.ai │
|
|
133
151
|
└─────────────┘ │ /rooms page │
|
|
134
152
|
└───────────────┘
|
|
135
153
|
```
|
|
@@ -171,7 +189,7 @@ quoroom serve
|
|
|
171
189
|
|
|
172
190
|
On first run, `quoroom serve` automatically registers the Quoroom MCP server in every AI coding tool you have installed (Claude Code, Claude Desktop, Cursor, Windsurf). Just **restart your AI client once** — after that, all `mcp__quoroom__*` tools are available automatically in every session.
|
|
173
191
|
|
|
174
|
-
Open **
|
|
192
|
+
Open **http://localhost:3700** (or the port shown in your terminal). The dashboard and API run locally, and your room data stays on your machine by default.
|
|
175
193
|
|
|
176
194
|
> **MCP-only mode** (no HTTP server): `quoroom mcp` starts just the stdio MCP transport, useful for scripting or testing. For normal use, `quoroom serve` is all you need.
|
|
177
195
|
|
|
@@ -281,10 +299,10 @@ The room engine exposes an MCP server over stdio. All tools use the `quoroom_` p
|
|
|
281
299
|
|
|
282
300
|
| Tool | Description |
|
|
283
301
|
|------|-------------|
|
|
284
|
-
| `quoroom_wallet_create` | Create an EVM wallet (
|
|
302
|
+
| `quoroom_wallet_create` | Create an EVM wallet (multi-chain) |
|
|
285
303
|
| `quoroom_wallet_address` | Get wallet address |
|
|
286
|
-
| `quoroom_wallet_balance` | Check
|
|
287
|
-
| `quoroom_wallet_send` | Send USDC |
|
|
304
|
+
| `quoroom_wallet_balance` | Check on-chain balance (USDC/USDT, all chains) |
|
|
305
|
+
| `quoroom_wallet_send` | Send USDC or USDT on any supported chain |
|
|
288
306
|
| `quoroom_wallet_history` | View transaction history |
|
|
289
307
|
|
|
290
308
|
### Identity
|
|
@@ -367,7 +385,7 @@ room/
|
|
|
367
385
|
│ ├── quorum.ts # Voting & decisions
|
|
368
386
|
│ ├── goals.ts # Goal decomposition
|
|
369
387
|
│ ├── skills.ts # Skill management
|
|
370
|
-
│ ├── wallet.ts # EVM wallet (
|
|
388
|
+
│ ├── wallet.ts # EVM wallet (multi-chain, USDC/USDT)
|
|
371
389
|
│ ├── identity.ts # ERC-8004 on-chain identity
|
|
372
390
|
│ ├── station.ts # Cloud provisioning
|
|
373
391
|
│ ├── task-runner.ts # Task execution engine
|
|
@@ -386,11 +404,19 @@ room/
|
|
|
386
404
|
|
|
387
405
|
</details>
|
|
388
406
|
|
|
389
|
-
##
|
|
407
|
+
## Model Providers
|
|
390
408
|
|
|
391
|
-
|
|
409
|
+
Run entirely free with Ollama, or use your existing Claude/ChatGPT subscription or API.
|
|
392
410
|
|
|
393
|
-
|
|
411
|
+
| Role | Provider | Cost |
|
|
412
|
+
|------|----------|------|
|
|
413
|
+
| **Queen** | [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | Subscription |
|
|
414
|
+
| | Codex (ChatGPT) | Subscription |
|
|
415
|
+
| | OpenAI API | Pay-per-use |
|
|
416
|
+
| | Claude API | Pay-per-use |
|
|
417
|
+
| | **Llama 3.2 via [Ollama](https://ollama.com)** | **Free** |
|
|
418
|
+
| **Workers** | [Ollama](https://ollama.com) models | **Free** |
|
|
419
|
+
| | Claude (subscription or API) | Subscription / API |
|
|
394
420
|
|
|
395
421
|
## License
|
|
396
422
|
|