quoroom 0.1.34 → 0.1.36

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
@@ -1,6 +1,6 @@
1
1
  <p align="center">
2
2
  <a href="https://quoroom.ai">
3
- <img src="docs/banner.png" alt="Quoroom — Autonomous AI agent collective." width="100%">
3
+ <img src="docs/banner.png?v=3" alt="Quoroom — Swarm Intelligence. Relentless Execution." width="100%">
4
4
  </a>
5
5
  </p>
6
6
 
@@ -18,9 +18,13 @@
18
18
 
19
19
  A single agent thinks. A collective decides. We're building the swarm.
20
20
 
21
- Queen, Workers, Quorum. Goals, skills, self-modification, wallet, stations starting on your machine, scaling to cloud.
21
+ Queen, Workers, Quorum. Goals, skills, self-modification, wallet — local-first on your machine, with optional cloud stations on quoroom.io.
22
22
 
23
- [quoroom.ai](https://quoroom.ai)
23
+ [Local](https://quoroom.ai) · [Cloud](https://quoroom.io)
24
+
25
+ Local/cloud split:
26
+ - Local app + install surface: `quoroom.ai`
27
+ - Cloud app + API + public rooms + stations: `quoroom.io`
24
28
 
25
29
  <p align="center">
26
30
  <video src="docs/demo.mp4" autoplay loop muted playsinline width="800"></video>
@@ -36,20 +40,21 @@ Queen, Workers, Quorum. Goals, skills, self-modification, wallet, stations — s
36
40
 
37
41
  Official channels only:
38
42
 
39
- - `https://quoroom.ai`
43
+ - `https://quoroom.ai` (local app/download)
44
+ - `https://quoroom.io` (cloud app/public rooms/stations)
40
45
  - `https://github.com/quoroom-ai`
41
46
  - Telegram: `@quoroom_ai_bot`
42
47
 
43
- If you see impersonation or scam activity, report it to `hello@quoroom.ai`.
48
+ If you see impersonation or scam activity, report it to `hello@quoroom.io`.
44
49
  See `TRADEMARKS.md` for full trademark usage terms.
45
50
 
46
51
  ---
47
52
 
48
53
  ## Why Quoroom?
49
54
 
50
- 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.
55
+ 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 and modify their own behavior. Cloud swarms can rent stations for more compute on quoroom.io — all governed by democratic consensus.
51
56
 
52
- Always-on autonomous execution is inevitable. It's already happening behind closed doors. We believe it should happen in the open — publicly, transparently — so everyone can learn. Quoroom is an experiment: let's see what AI swarms can actually execute.
57
+ Continuous autonomous execution is becoming widespread. It's already happening behind closed doors. We believe it should happen in the open — publicly, transparently — so everyone can learn. Quoroom is an experiment: let's see what AI swarms can actually execute.
53
58
 
54
59
  The architecture draws from swarm intelligence research: decentralized decision-making, emergent behavior from local interactions, and collective intelligence that exceeds any individual agent. The queen doesn't dictate — the swarm decides.
55
60
 
@@ -66,7 +71,7 @@ Quoroom is an open research project exploring autonomous agent collectives. Each
66
71
 
67
72
  ## This Repo
68
73
 
69
- `quoroom-ai/room` is the engine: agent loop, quorum governance, goals, skills, self-modification, wallet, stations, memory, task scheduling, MCP server, HTTP/WebSocket API, dashboard UI, and CLI.
74
+ `quoroom-ai/room` is the engine: agent loop, quorum governance, goals, skills, self-modification, wallet, cloud station controls, memory, task scheduling, MCP server, HTTP/WebSocket API, dashboard UI, and CLI.
70
75
 
71
76
  | Repo | Purpose |
72
77
  |------|---------|
@@ -95,7 +100,7 @@ Quoroom is an open research project exploring autonomous agent collectives. Each
95
100
 
96
101
  **On-Chain Identity** — ERC-8004 agent identity on Base. Rooms register as on-chain agents with discoverable metadata. Reputation-ready.
97
102
 
98
- **Stations** — Workers rent cloud servers when they need more compute. Deploy to Fly.io, E2B, or Modal with exec, logs, and domain management.
103
+ **Stations (cloud mode only)** — Station rental is available only for cloud swarms on quoroom.io. In local mode, station tools and the Stations tab are hidden/blocked.
99
104
 
100
105
  **Task Scheduling** — Recurring (cron), one-time, on-demand, or **webhook-triggered** tasks with session continuity and auto-nudge.
101
106
 
@@ -103,7 +108,7 @@ Quoroom is an open research project exploring autonomous agent collectives. Each
103
108
 
104
109
  **Keeper Control Model** — Rooms run in a keeper-controlled mode with full dashboard/API control for agent and user tokens. Cloud member tokens are read-only plus limited collaboration endpoints (vote, resolve/reply, mark read).
105
110
 
106
- **Public Rooms** — Toggle your room public on [quoroom.ai/rooms](https://quoroom.ai/rooms). Live room stats and activity appear on the leaderboard. Room registers with cloud and sends heartbeats every 5 minutes. No account needed to browse.
111
+ **Public Rooms** — Toggle your room public on [quoroom.io/rooms](https://quoroom.io/rooms). Live room stats and activity appear on the leaderboard. Room registers with cloud and sends heartbeats every 5 minutes. No account needed to browse.
107
112
 
108
113
  **HTTP Server + REST API** — Full REST API with dual-token auth (agent + user) and WebSocket real-time events. Cloud member role uses constrained collaboration access. Run `quoroom serve` to start.
109
114
 
@@ -111,7 +116,7 @@ Quoroom is an open research project exploring autonomous agent collectives. Each
111
116
 
112
117
  **Clerk** — A fully functional keeper assistant in the dashboard. It can chat across all rooms, remember context and history, act proactively, and execute management actions (create/update rooms, tasks, reminders, messaging) while streaming live commentary about swarm activity.
113
118
 
114
- **Cloud Mode** — Deploy to the cloud and control your room remotely. Same dashboard works in both local and cloud mode. Cloud instances auto-detect their environment, support JWT-based auth, and serve the UI over HTTPS with strict CORS. Connect your Claude or Codex subscription from the remote Settings panel.
119
+ **Cloud Mode** — Deploy to the cloud on quoroom.io and control your room remotely. Same dashboard works in both local and cloud mode. Cloud instances auto-detect their environment, support JWT-based auth, and serve the UI over HTTPS with strict CORS. Connect your Claude or Codex subscription from the remote Settings panel.
115
120
 
116
121
  **Inbox** — Rooms can message the keeper and other rooms. Cross-room communication with reply threading. Agents escalate decisions, share updates, or request resources from neighboring rooms.
117
122
 
@@ -138,7 +143,7 @@ Quoroom is an open research project exploring autonomous agent collectives. Each
138
143
  │ │
139
144
  │ ┌────────┐ ┌──────────┐ ┌────────────────┐ │
140
145
  │ │ Wallet │ │ Stations │ │ Task Scheduler │ │
141
- │ │(EVM) │ │(Fly/E2B) │ │cron/once/hook │ │
146
+ │ │(EVM) │ │(cloud) │ │cron/once/hook │ │
142
147
  │ └────────┘ └──────────┘ └────────────────┘ │
143
148
  │ │
144
149
  │ ┌──────────────────────────────────────────┐ │
@@ -160,7 +165,7 @@ Quoroom is an open research project exploring autonomous agent collectives. Each
160
165
  │ │
161
166
  ┌──────┴──────┐ ┌───────┴───────┐
162
167
  │ Dashboard │ │ Cloud Sync │
163
- │ localhost │ │ quoroom.ai
168
+ │ localhost │ │ quoroom.io
164
169
  └─────────────┘ │ /rooms page │
165
170
  └───────────────┘
166
171
  ```
@@ -183,7 +188,7 @@ brew install quoroom-ai/quoroom/quoroom
183
188
 
184
189
  ### Download
185
190
 
186
- Download from [GitHub Releases](https://github.com/quoroom-ai/room/releases). Installers add `quoroom` to your PATH automatically. No dependencies needed.
191
+ Download from [GitHub Releases](https://github.com/quoroom-ai/room/releases). Installers add `quoroom` to your PATH automatically. No dependencies needed. The installer bundles only Node.js v20 — no third-party software, toolbars, or extensions are included.
187
192
 
188
193
  Installer launchers:
189
194
  - macOS `.pkg`: open `/Applications/Quoroom Server.app`
@@ -378,21 +383,21 @@ The room engine exposes an MCP server over stdio. All tools use the `quoroom_` p
378
383
  | `quoroom_identity_get` | Get on-chain identity (agentId, registry, URI) |
379
384
  | `quoroom_identity_update` | Update on-chain registration metadata |
380
385
 
381
- ### Stations
386
+ ### Stations (cloud mode only)
382
387
 
383
388
  | Tool | Description |
384
389
  |------|-------------|
385
- | `quoroom_station_create` | Provision a cloud server (Fly.io, E2B, Modal) |
386
- | `quoroom_station_list` | List stations |
387
- | `quoroom_station_status` | Get station status |
388
- | `quoroom_station_start` | Start a stopped station |
389
- | `quoroom_station_stop` | Stop a running station |
390
- | `quoroom_station_exec` | Execute a command on a station |
391
- | `quoroom_station_logs` | View station logs |
392
- | `quoroom_station_delete` | Delete a station |
393
- | `quoroom_station_cancel` | Cancel a pending station |
394
- | `quoroom_station_create_crypto` | Provision a station with crypto payment |
395
- | `quoroom_station_renew_crypto` | Renew a station with crypto payment |
390
+ | `quoroom_station_create` | Provision a cloud station on quoroom.io (cloud mode only) |
391
+ | `quoroom_station_list` | List stations (cloud mode only) |
392
+ | `quoroom_station_status` | Get station status (cloud mode only) |
393
+ | `quoroom_station_start` | Start a stopped station (cloud mode only) |
394
+ | `quoroom_station_stop` | Stop a running station (cloud mode only) |
395
+ | `quoroom_station_exec` | Execute a command on a station (cloud mode only) |
396
+ | `quoroom_station_logs` | View station logs (cloud mode only) |
397
+ | `quoroom_station_delete` | Delete a station (cloud mode only) |
398
+ | `quoroom_station_cancel` | Cancel a pending station (cloud mode only) |
399
+ | `quoroom_station_create_crypto` | Provision a station with crypto payment (cloud mode only) |
400
+ | `quoroom_station_renew_crypto` | Renew a station with crypto payment (cloud mode only) |
396
401
 
397
402
  ### Inbox
398
403