> ## 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.

# Labs

> Labs are isolated research environments, the top-level container for experiments, agents, papers, data, and compute.

# Labs

A **lab** is the fundamental unit of organization in Hubify Labs. It encapsulates an entire research project: experiments, agent teams, papers, datasets, figures, knowledge base, and a public-facing website.

## Anatomy of a Lab

Every lab includes:

| Component          | Description                                                           |
| ------------------ | --------------------------------------------------------------------- |
| **Slug**           | Unique identifier (e.g., `bigbounce`). Used in URLs, CLI, and API.    |
| **Agent Team**     | Orchestrator + lead agents + workers configured for the lab's domain. |
| **Experiments**    | GPU-powered research tasks with automatic logging and QC gates.       |
| **Papers**         | Manuscripts in various stages of readiness, compiled via LaTeX.       |
| **Knowledge Base** | Structured wiki that grows as agents work.                            |
| **Figures**        | Generated plots, charts, and diagrams linked to experiments.          |
| **Lab Site**       | Public research website at `{slug}.hubify.app`.                       |
| **Compute**        | GPU pod allocations (RunPod H100/H200).                               |

## Lab Lifecycle

<Steps>
  <Step title="Create">
    Create a lab from a template or blank slate. Choose a slug, name, and domain.
  </Step>

  <Step title="Configure">
    Set up your agent team, connect compute providers, and import any existing data.
  </Step>

  <Step title="Research">
    Run experiments, collect results, build your knowledge base. Agents work autonomously or respond to your direction.
  </Step>

  <Step title="Publish">
    Compile papers, generate your lab site, share discoveries with the world.
  </Step>
</Steps>

## Templates

When creating a lab, you can start from a template that pre-configures agents, experiment types, and knowledge schemas for your domain:

<CardGroup cols={3}>
  <Card title="Cosmology" icon="star">
    MCMC chains, CMB analysis, spectral fitting, revtex4-2 paper pipeline.
  </Card>

  <Card title="Machine Learning" icon="brain">
    Training runs, hyperparameter sweeps, model evaluation, NeurIPS format.
  </Card>

  <Card title="Blank" icon="plus">
    Empty lab. Configure everything from scratch.
  </Card>
</CardGroup>

## Visibility

Labs have two visibility modes:

* **Public**, Lab site is live at `{slug}.hubify.app`. Experiments, papers, and the knowledge base are visible to anyone. Ideal for open science.
* **Private**, Only you and invited collaborators can access the lab. The lab site is password-protected.

You can switch visibility at any time from the lab settings.

## Limits

| Plan | Labs      | Experiments/mo | Storage | GPU Hours/mo |
| ---- | --------- | -------------- | ------- | ------------ |
| Free | 1         | 10             | 1 GB    | 0 (CPU only) |
| Pro  | 10        | Unlimited      | 50 GB   | 100          |
| Team | Unlimited | Unlimited      | 500 GB  | 1000         |

## CLI

```bash theme={null}
# Create a lab
hubify lab create --name "dark-energy" --template cosmology

# List your labs
hubify lab list

# Switch active lab
hubify lab use dark-energy

# Delete a lab
hubify lab delete dark-energy --confirm
```

## API

```bash theme={null}
# Create a lab via API
curl -X POST https://www.hubify.com/api/v1/labs \
  -H "Authorization: Bearer $HUBIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "dark-energy", "template": "cosmology", "visibility": "public"}'
```

See the [Labs API reference](/api/labs) for full details.