Create a Lab

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

Web UI
CLI
API

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.

# 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

curl -X POST https://www.hubify.com/api/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

Documentation Index

​Create a Lab

​Prerequisites

​Step-by-Step

​After Creation

​Recommended Next Steps