Team mode stays in the repository but is not built or shipped (ADR-0003). - The team server (index.ts, config, db, daemons, plugins, proactive, routes, scheduler, services, ws, drizzle migrations) and its tests move from @waggle/server to packages/team-server (@waggle/team-server, private). It keeps its own copies of the logger and the agent-group executor, so it does not import @waggle/server. @clerk/fastify, bullmq, ioredis, postgres, drizzle-orm, drizzle-kit, cron-parser and @waggle/waggle-dance leave @waggle/server; the launcher drops the same team-only dependencies. - build:packages no longer builds waggle-dance or the worker: nothing in the community edition imports them, and the worker's project reference would otherwise build the team server. The worker now imports from team-server; the team Dockerfile builds both explicitly. - The sidecar no longer starts the team server when DATABASE_URL is set, and loses the team routes (/api/team/*, /api/teams), the WaggleDance routes and bridge (/api/waggle-dance/*), the Team server binding and egress guard, the WebSocket team client, the TeamSync cache and pushes, team audit forwarding, team workspace registration and the team capability-policy lookup in chat. The in-process room signal bus stays: agent groups, fleet runs and external tool runs use it. middleware/audit.ts was dead and is deleted. - @waggle/core loses TeamSync and the teamServer part of WaggleConfig. A teamServer key in config.json is ignored and kept on save, as P0.1 does for the tier keys. Workspaces lose teamServerUrl and teamUserId; teamId and teamRole stay because workspaces from a shared data directory still carry them and the viewer write guards read them. POST /api/workspaces ignores team fields. - The sidecar bundle no longer marks the team packages as external. The agent still references the TeamSync type in orchestrator.ts and pattern-write-back.ts; those files are being rewritten in P1.5 and drop it there. Logs UF-030 and UF-031 (team sync and team policy defects found while removing the code).
Waggle OS Community Edition
Waggle is a local-first AI workspace: an agent with persistent memory, personas, skills, connectors and scheduled automations. It runs as a Node.js sidecar with a React web UI, and can be wrapped in a Tauri desktop shell. You bring your own model: a local model through Ollama or a provider API key.
Status: work in progress. This branch is being converted from the commercial Waggle OS codebase into an open-source community edition. Billing, KVARK, compliance reporting and self-learning are already removed; memory is moving to a local mem0 store, and installers for Windows, macOS and Linux are not ready yet. The rules for this conversion are in
AGENTS.mdand the decision records indocs/oss/adr/.
Repository layout
waggle-os/
├── apps/web/ # Web UI (React 19, Vite, Tailwind 4)
├── app/ # Tauri 2 desktop shell (Rust); loads the apps/web build
├── packages/ # npm workspaces: agent, server, core, shared, marketplace,
│ # memory-contract, memory-mem0, cli, launcher, sdk, weaver, ...
└── docs/ # Guides, reference, and docs/oss for the community edition
AGENTS.md lists the status of every package in this edition.
Run from source
Prerequisites: Node.js ^20.19.0 or >=22.12.0, and npm.
npm install
npm run build:packages # workspace packages export dist/; the sidecar needs it
npm run build # builds the web UI into dist/
npm run dev:server # the sidecar on http://localhost:3333, serving the UI
Open http://localhost:3333. Rebuild the UI and restart the sidecar to see UI changes:
the Vite dev server (npm run dev:web) cannot authenticate against the sidecar yet
(UF-003 in docs/oss/upstream-fixes.md).
Provider keys are entered in the app under Settings → API Keys and stored in the
encrypted vault, so a basic local run needs no .env file. .env.example lists the
optional variables.
Embeddings. By default EMBEDDING_PROVIDER=auto downloads a small in-process model
(about 23 MB, cached under ~/.waggle/models/) and works offline. To use Ollama instead,
install Ollama, run ollama pull nomic-embed-text, and set
EMBEDDING_PROVIDER=ollama.
| Variable | Description |
|---|---|
ANTHROPIC_API_KEY |
Claude API key; can be set in the app instead. |
OPENAI_API_KEY |
Enables OpenAI models and optional OpenAI embeddings. |
EMBEDDING_PROVIDER |
auto (default), inprocess, ollama, voyage, openai or mock. |
LITELLM_BASE_URL |
Optional external LiteLLM-compatible proxy. |
Checks
npm run build:packages # build all workspace packages
npm run typecheck:web # type-check the web UI
npm run lint # lint the packages
npm run check:deps # every import is a declared dependency
npm test # unit tests
Known failures and the numbers to compare against are in
docs/oss/baseline.md.
Documentation
The guides predate the community edition and still describe some removed features; they are rewritten before the first release.
License
This repository is licensed under the MIT License, except the
hive-mind-* packages under packages/, which are licensed under Apache-2.0.
Each hive-mind-* package carries its own LICENSE file, which governs that
package.