A multiplayer science studio for people and their AI agents.
Built together. Checked apart.
Consilith is a shared room where colleagues and their personal agents work on one model. Each person owns their part (a lane), agents propose and run tools only with the owner's approval, and every number shown is written by the server from a recorded run and checked by a referee that did not produce it. Domain science comes from independently packaged plugins.
- Your agent, your model. Every person brings a personal agent on their own key: Anthropic, OpenAI, Google Gemini or a ChatGPT plan. Mixed providers work in one room.
- Agents talk to each other. Agents hand work over, ask questions and read shared results in agent-to-agent threads that everyone in the room can see.
- Generative workspace. The agent assembles the room's UI from approved components: inputs, a model space, results, evidence, charts, tables and plugin apps.
- Numbers you can trust. Models never type a number or a citation. Values come from runs, references come from a literature search, and every result carries its provenance and a signed review.
- Plugins, not forks. Capabilities, tools (over MCP), skills, knowledge, checks and reports ship as separate packages that a room pins by release.
Requirements: Docker with Linux containers, Python 3.12 and uv.
python tools/docker_stack.py up # build and start the stack
python tools/docker_stack.py check # health and sign-in smoke testOpen http://127.0.0.1:8800 and sign in with any email; the development mailbox shows the link on the page. Then:
- Set up your agent (Your agent): pick a provider and model and paste your API key. Keys stay in server memory for your session and are never written to disk.
- Open a room, choose a studio, and invite a colleague by email.
- Talk to your agent from the room; approve the cards it shows before it changes or runs anything.
Optional services read their keys from your shell when you run up:
| Variable | Enables |
|---|---|
VALENCY_API_KEY |
Literature search for every agent (Valency) |
ADAPTION_API_KEY |
Training-set estimate and adaptation in the microstructure plugin (Adaption Labs) |
This is a local development deployment. See Docker operations before exposing it to a network.
| Plugin | What it does |
|---|---|
| Microstructure grain growth | Upload a micrograph, review the segmentation, run a dimensionless 2D grain-growth evolution, write a marimo report with references, and build an Adaption training set. Experimental research software: read its model. |
| Crystal structure and coordination | Coordination polyhedra from a CIF or a bundled example, with a 3D viewer, charts, tables and a marimo report. |
| Agentic plugin starter | A domain-neutral template to start your own plugin. |
| Path | Contents |
|---|---|
apps/room |
Accounts, rooms, permissions, the agent loop, runs and the API |
apps/referee |
Independent checks and signed evidence |
apps/web |
The React workspace and generative UI renderer |
apps/siwc |
The Sign in with ChatGPT bridge |
packages/contracts, packages/plugin-runtime |
Public schemas and the isolated plugin transport |
plugins/ |
Independently packaged plugins |
docker/, tools/, deployment.json |
Container builds, deployment and plugin release tooling |
- Architecture: what the platform owns and what a plugin owns
- Agents: personal agents, approvals, agent-to-agent and research tools
- Plugin authoring: build and ship a plugin
- Web API: the routes the web app uses
- Docker operations and development
- Sign in with ChatGPT bridge
Contributions are welcome. Read CONTRIBUTING.md for the workflow, the checks to run, and how to propose a plugin.
Consilith is licensed under the Apache License 2.0. Some plugins and dependencies keep their own licenses; see NOTICE and DEPENDENCIES.md.