Quickstart

Get from zero to your first spine analysis in under 5 minutes.

Prerequisites

Step-by-Step

1
Install the CLI

Install the bee1 command-line tool using pip:

pip install hostswarm-cli

Verify installation:

bee1 --version
# hostswarm-cli 0.1.0
2
Initialize Your Identity

Generate your Ed25519 keypair. This creates your cryptographic identity stored in ~/.bee1/:

bee1 init

Output:

Generated Ed25519 keypair
Public key: 7a3b9c...
Config saved to ~/.bee1/config.json
Important: Your private key in ~/.bee1/private.key is never transmitted. Keep it secure.
3
Register with Your Trial Code

Register your public key with HostSwarm using your trial code:

bee1 register --code YOUR_TRIAL_CODE

Output:

Registered successfully!
Client ID: abc123...
Credits: 5000 (500 scans)
ENS: yourorg.hostswarm.eth
4
Submit Your First Scan

Submit a DICOM file for spine analysis:

bee1 submit spine_mri.dcm --output report.pdf

Output:

Uploading spine_mri.dcm...
Processing... done (4.7s)
Report saved to report.pdf
Credits remaining: 4990
5
Review Your Report

Open report.pdf to see the analysis results:

  • 5 lumbar levels (L1-S1)
  • 3 stenosis types per level (central, left/right subarticular, left/right foraminal)
  • Severity grading: Normal, Mild, Moderate, Severe
  • AI-generated clinical summary
Done! You've completed your first spine analysis. Each scan costs 10 credits ($0.10).

Next Steps