> ## Documentation Index
> Fetch the complete documentation index at: https://hubify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# hubify lab

> Lab management commands, create, switch, list, update, and delete research labs.

# hubify lab

Manage research labs. A lab is your top-level research environment containing experiments, agents, papers, data, and a public website.

## Commands

### `hubify lab create`

Create a new research lab:

```bash theme={null}
hubify lab create \
  --name "Dark Energy Constraints" \
  --slug dark-energy \
  --template cosmology \
  --visibility public
```

| Option          | Required | Default        | Description                                     |
| --------------- | -------- | -------------- | ----------------------------------------------- |
| `--name`        | Yes      | ,              | Human-readable lab name                         |
| `--slug`        | No       | Auto from name | URL identifier (`{slug}.hubify.app`)            |
| `--template`    | No       | `blank`        | Template: `cosmology`, `ml`, `biology`, `blank` |
| `--visibility`  | No       | `private`      | `public` or `private`                           |
| `--description` | No       | ,              | Brief description of the research goal          |

### `hubify lab list`

List all labs you have access to:

```bash theme={null}
hubify lab list
```

```
NAME                     SLUG          TEMPLATE    VISIBILITY  EXPERIMENTS
Dark Energy Constraints  dark-energy   cosmology   public      42
Galaxy Chirality         chirality     blank       public      18
Test Lab                 test-lab      blank       private     3
```

### `hubify lab use`

Switch the active lab:

```bash theme={null}
hubify lab use dark-energy
```

All subsequent commands will target this lab unless overridden with `--lab`.

### `hubify lab info`

Show detailed information about a lab:

```bash theme={null}
hubify lab info dark-energy
```

```
Name:         Dark Energy Constraints
Slug:         dark-energy
Template:     cosmology
Visibility:   public
Created:      2026-03-15
Experiments:  42 (3 running, 39 complete)
Agents:       6 (1 orchestrator, 2 leads, 3 workers)
Papers:       2 (78% and 45% readiness)
Site:         https://dark-energy.hubify.app
Compute:      RunPod connected ($312 MTD)
```

### `hubify lab update`

Update lab settings:

```bash theme={null}
# Update name
hubify lab update dark-energy --name "Dark Energy & Modified Gravity"

# Change visibility
hubify lab update dark-energy --visibility private

# Update description
hubify lab update dark-energy --description "Constraining w0-wa with DESI+Planck"
```

### `hubify lab delete`

Delete a lab (requires confirmation):

```bash theme={null}
hubify lab delete dark-energy --confirm
```

<Warning>
  Deleting a lab removes all experiments, papers, agents, and the public site. This action cannot be undone. Export your data first.
</Warning>

### `hubify lab export`

Export all lab data:

```bash theme={null}
hubify lab export dark-energy --output ./dark-energy-backup.tar.gz
```

The export includes experiments, results, papers, knowledge base entries, and configuration.

## Examples

```bash theme={null}
# Create a lab from a template and start working
hubify lab create --name "Bounce Cosmology" --template cosmology
hubify lab use bounce-cosmology
hubify experiment run "Test MCMC chain with Planck base"

# List labs as JSON for scripting
hubify lab list --json | jq '.[].slug'
```