Skip to main content

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.

​
Troubleshooting

Solutions for common issues across the CLI, web UI, agents, compute, and paper pipeline.

​
CLI Issues

The CLI is not in your PATH. Fix depends on your install method:
# npm: add global bin to PATH
export PATH="$(npm config get prefix)/bin:$PATH"

# Add to your shell profile (~/.zshrc or ~/.bashrc)
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Tokens expire periodically. Re-authenticate:
hubify auth login
For CI environments, create a long-lived token:
hubify auth token --create --name "ci" --ttl 90d
Commands run against the active lab. Switch labs:
# Check current lab
hubify lab info

# Switch
hubify lab use correct-lab-slug

# Or override per-command
hubify experiment list --lab correct-lab-slug
The CLI communicates with www.hubify.com/api over HTTPS. Check your network:
curl -I https://www.hubify.com/api/v1/health
If behind a proxy:
export HTTPS_PROXY=https://proxy.example.com:8080

​
Agent Issues

Check agent status:
hubify agent list
If an agent shows as stuck, restart it:
hubify agent update "Research Lead" --status active
Verify external API keys are configured:
hubify agent review-config --show
If a provider’s key is expired or invalid, update it:
hubify agent review-config --add-reviewer gpt-5.4 --api-key $NEW_OPENAI_KEY
Ensure auto-scheduling is enabled:
hubify agent update orchestrator --auto-schedule true
Check if the orchestrator is overloaded:
hubify agent metrics orchestrator

​
Compute Issues

The requested GPU may be out of stock. Check availability:
hubify pod list --available
Try a different GPU type or region:
hubify experiment rerun EXP-051 --override "pod=a100"
Reduce batch size or upgrade GPU:
  • H100 (80 GB) handles most workloads
  • H200 (141 GB) for the largest datasets
For PyTorch, enable gradient checkpointing to reduce memory:
model.gradient_checkpointing_enable()
Find and terminate idle pods:
hubify pod list --json | jq '.[] | select(.status=="idle")'
hubify pod stop pod-idle-123
Prevent future waste by setting an idle timeout:
hubify pod config --idle-timeout 15m
When the monthly budget is hit, new experiments queue instead of launching:
# Check budget
hubify pod budget --show

# Increase limit
hubify pod budget --monthly 750

# Or wait until next month

​
Paper Issues

Figures must be in the same directory as the .tex file. The compile command handles this, but verify:
hubify paper compile paper-1 --check
If the PDF is under 1 MB, figures are not embedded.
Run compilation multiple times (the compile command does this automatically):
hubify paper compile paper-1
If references persist, check that all \cite{} keys exist in your .bib file.
Common issues:
  • Using \citep/\citet, use \cite{} with revtex4-2
  • Using \deluxetable, use \begin{table}\begin{ruledtabular}\begin{tabular}
  • Using aastex631 class, use revtex4-2
View the full compile log:
hubify paper compile paper-1 --verbose

​
Lab Site Issues

Force a sync and redeploy:
hubify site sync
hubify site deploy
Verify DNS and SSL:
hubify site domain --status
Ensure your CNAME record points to cname.hubify.app. SSL provisioning takes 1-5 minutes.

​
Getting Help

If your issue is not listed here: 
# Check system status
hubify status --system

# View debug logs
hubify logs --system --level debug --since "1h ago"

# Contact support
hubify support "Description of your issue"