Start Here
This section is for the first ten minutes with OASIS ScienceClaw.
OASIS ScienceClaw is a reproducible scientific working group environment. The container gives you a ready-to-use runtime, the repository gives you durable project memory, and the workspace gives agents and humans a shared place to write down decisions, notes, tasks, data manifests, and reviewed outputs.
You do not need to understand Docker deeply to begin
Start by treating the container as a portable lab bench: it holds the tools. The repository is the lab notebook: it holds the memory.
The Core Mental Model
flowchart LR
GitHub["GitHub\ncontrol plane"] --> Repo["Repository\nproject memory"]
Repo --> Container["Container\nruntime and tools"]
Secrets["Secrets\ninjected locally"] --> Container
Storage["External storage\nlarge data and outputs"] --> Container
Container --> Workspace["Workspace\nactive scientific work"]
Workspace --> Review["Human review\nbefore publishing"]
Repeat this when you feel lost:
GitHub = control plane. Repo = memory. Container = runtime. Secrets are injected, never stored. External storage holds large durable data.
First Path
- Read First 10 Minutes.
- Launch the workspace with Launch Locally.
- Open the Working Group Cockpit.
- Learn Where Files Go.
- Check the Troubleshooting page if anything feels strange.
The calm command loop is:
make init-working-group
make doctor
make checkpoint
User Modes
| Mode | Start With | Main Concern |
|---|---|---|
| Everyday Scientist | First 10 Minutes | Doing useful work without learning infrastructure first |
| Working Group Lead | Create from Template | Making a reusable working group from the base image |
| Data/Workflow Maintainer | Where Files Go | Data placement, provenance, and reproducible outputs |
| Infrastructure Admin | Operations | Ports, credentials, startup, and deployment |
| Developer/Customizer | Template Governance | Extending agents, docs, branding, and workflows |