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 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 for USDC on Base L2. Encrypted keys (AES-256-GCM). Agents can send and receive funds.
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 [app.quoroom.ai](https://app.quoroom.ai). Manage rooms, agents, goals, memory, wallet — all from the browser. The UI loads from CDN but connects to your local server — all data stays on your machine.
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
- │ │(Base L2)│ │(Fly/E2B) │ │ (cron/once) │ │
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
- app.quoroom │ │ quoroom.ai │
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 **[app.quoroom.ai](https://app.quoroom.ai)** the dashboard loads from CDN but all API calls go to `localhost`. Your data never leaves your machine.
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 (USDC on Base) |
302
+ | `quoroom_wallet_create` | Create an EVM wallet (multi-chain) |
285
303
  | `quoroom_wallet_address` | Get wallet address |
286
- | `quoroom_wallet_balance` | Check USDC balance |
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 (Base L2, USDC)
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
- ## No API keys needed
407
+ ## Model Providers
390
408
 
391
- No ChatGPT API. No Claude API. The queen uses your [Claude Code](https://docs.anthropic.com/en/docs/claude-code) subscription. Workers use [Ollama](https://ollama.com) — free, open-source LLMs. Scale up with stations.
409
+ Run entirely free with Ollama, or use your existing Claude/ChatGPT subscription or API.
392
410
 
393
- Quoroom is not affiliated with Anthropic or OpenAI.
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