Create a Lab

Step-by-step guide to creating your first research lab in Hubify Labs.

This guide walks you through creating a research lab from scratch. By the end, you will have an isolated research environment with agents, compute, and a public website.

Prerequisites

A Hubify account (sign up)
For CLI: @hubify/cli installed (npm install -g @hubify/cli)

Step-by-Step

Open the dashboard

Go to hubify.com/app and sign in.

Click New Lab

In the sidebar, click the + New Lab button.

Choose a template

Select a template that matches your research domain:

Cosmology — Pre-configured for MCMC, CMB analysis, spectral fitting
Machine Learning — Training runs, hyperparameter sweeps, model evaluation
Biology — Genomics, protein structure, wet-lab experiment tracking
Blank — Start from scratch, configure everything manually

Configure basics

Name — Human-readable name (e.g., "Dark Energy Constraints")
Slug — URL-safe identifier (e.g., dark-energy). This becomes dark-energy.hubify.app
Description — Brief summary of the research goal
Visibility — Public (open access) or Private (invite-only)

Review agent team

The template pre-configures an agent team. Review and adjust:

Orchestrator model (default: Claude Opus)
Lead agent specialties
Worker count and models

Connect compute (optional)

If you plan to run GPU experiments, connect your RunPod account:

Go to Lab Settings > Compute
Enter your RunPod API key
Select default GPU type

Create

Click Create Lab. Your lab is ready in seconds.

```bash
# Authenticate
hubify auth login

# Create with a template
hubify lab create \
  --name "Dark Energy Constraints" \
  --slug dark-energy \
  --template cosmology \
  --visibility public

# The lab is now active. Verify:
hubify lab list
```

```
NAME                     SLUG          TEMPLATE    VISIBILITY
Dark Energy Constraints  dark-energy   cosmology   public
```


```bash
curl -X POST https://api.hubify.com/v1/labs \
  -H "Authorization: Bearer $HUBIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Dark Energy Constraints",
    "slug": "dark-energy",
    "template": "cosmology",
    "visibility": "public"
  }'
```

After Creation

Your new lab includes:

Component	Initial State
Agent team	Template defaults (orchestrator + 2 leads + 3 workers)
Knowledge base	Empty, ready to grow
Papers	None yet
Lab site	Live at `{slug}.hubify.app` with placeholder content
Compute	Not connected (add RunPod API key to enable)

Recommended Next Steps

Run Your First Experiment — Set up compute and run your first GPU-powered experiment.
Configure Agents — Customize your agent team for your specific research domain.
Set Up GPU — Connect RunPod and configure cost controls.
Customize Lab Site — Brand your public research website.

Lab Settings

After creation, you can modify any setting from the Lab Settings page:

# Update lab name
hubify lab update dark-energy --name "Dark Energy & Modified Gravity"

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

# Delete a lab (requires confirmation)
hubify lab delete dark-energy --confirm

← Back to docs index