Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hiverge.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Creating an experiment

hive create exp my-experiment-
Adding a - suffix to the experiment name appends a random unique ID to it. We recommend using this to avoid clashes where two experiments share the same name. By default, hive create exp uses the default YAML file located at ~/.hive/config.yaml. To use a different file, pass the --config (or -f) flag: 
hive create exp my-experiment- -f /path/to/config.yaml
This is useful when managing multiple experiment configurations.

​
Listing experiments

hive list exp

NAME                  AGENTS  STATUS          AGE
my-experiment-abc123  10/10   Running         5m
test-exp-xyz789       0/10    ImageBuilding   2h
debug-exp-abc789      5/10    InProgress      15m
ColumnMeaning
NAMEExperiment identifier
AGENTSready/total — e.g. 8/10 means 8 of 10 agents are ready
STATUSCurrent experiment phase (see below)
AGETime since creation
Experiments progress through these phases:
StatusDescription
PendingExperiment submitted, waiting to start
ImageBuildingBuilding container images
InProgressAgents are being initialized
RunningAgents are executing experiments
CompletedAll agents finished successfully

​
Viewing experiment details

hive get exp my-experiment-abc123

apiversion: v1alpha1
name: my-experiment-abc123
spec
  repo
    source:             https://github.com/your-org/repo.git
    branch:             main
    evaluation_script:  evaluation.py
    target_code:        main.py
  runtime
    agents:          10/10
    max_runtime:     -1
    max_iterations:  -1
  sandbox
    base_image:          python:3.9-slim
    evaluation_timeout:  60s
    setup_script:
      pip install -r requirements.txt
    resources:
      cpu:    2
      memory: 4Gi
status
  created: 2026-04-22T10:30:00Z (2h ago)
  phase:   Running
  message: Experiment is running successfully
Output sections:
  • name: Experiment identifier
  • spec: Experiment specification
    • repo: Source code repository configuration
    • runtime: Execution settings (agents shows ready/total, e.g., 10/10)
    • sandbox: Container environment and resources
  • status: Current state
    • created: Creation timestamp and age
    • phase: Current lifecycle phase
    • message: Condition message (if available)

​
Deleting experiments

hive delete exp my-experiment-abc123
To delete multiple experiments at once: 
hive delete exp exp-1 exp-2 exp-3
Add --yes (or -y) to skip the confirmation prompt: 
hive delete exp exp-1 exp-2 exp-3 -y

​
Viewing the dashboard

The experiment dashboard, which contains detailed information about all Hive experiments launched by your team, can be accessed by using: 
hive dashboard