install-deps → select-branches → install-all → build-all → verify-build → run-dev-stack → test-integration

bash scripts/install_deps.sh

--check         # check only, don't install anything
--conda         # only install conda
--node          # only install node + nvm
--pnpm          # only install pnpm

bash scripts/select_branches.sh

undefined

Branch selections are saved to `$WORKSPACE/.dev-branches` and automatically loaded by `install_all.sh`, `build_all.sh`, and `verify_build.sh`.

---

bash scripts/install_all.sh

--skip-hbot      # skip hummingbot conda install
--skip-gateway   # skip gateway pnpm install
--skip-api       # skip hummingbot-api install
--no-local-hbot  # use PyPI hummingbot in API env instead of local source

bash scripts/build_all.sh

--wheel-only     # only build hummingbot wheel, no Docker
--no-docker      # skip all Docker builds
--no-hbot        # skip hummingbot builds
--no-gateway     # skip gateway builds
--no-api         # skip hummingbot-api builds
--tag <name>     # Docker tag (default: dev)

bash scripts/verify_build.sh

bash scripts/verify_build.sh --no-docker   # skip Docker checks
bash scripts/verify_build.sh --no-running  # skip service checks
bash scripts/verify_build.sh --json        # JSON output

bash scripts/run_dev_stack.sh

--no-gateway           # skip gateway start
--passphrase <pass>    # gateway passphrase (default: hummingbot)
--stop                 # stop everything
--status               # show running status

bash scripts/check_env.sh --json

bash scripts/check_repos.sh --json

bash scripts/check_api.sh --json
bash scripts/check_gateway.sh --json

Dev Environment Status
======================
  [x] Prerequisites     — conda, node, pnpm, docker, git OK
  [x] Hummingbot repo   — branch: development, env: hummingbot (installed)
  [x] Gateway repo      — branch: development, built: yes
  [x] Hummingbot API    — running at http://localhost:8000
  [x] Gateway           — running at http://localhost:15888
  [ ] Local hummingbot  — hummingbot-api NOT using local source

Next: run /hummingbot-developer setup-api-dev to wire API to local source

bash scripts/check_env.sh

cd <HUMMINGBOT_DIR>
git fetch origin
git checkout development
git pull origin development

sed -i '' '/solders/d' setup/environment.yml 2>/dev/null || sed -i '/solders/d' setup/environment.yml

make install

conda run -n hummingbot pip install "solders>=0.19.0"

  [x] conda env "hummingbot" created
  [x] solders installed via pip
  Run hummingbot: /hummingbot-developer run-hummingbot
  Build image:    /hummingbot-developer build-hummingbot

cd <HUMMINGBOT_DIR>
conda activate hummingbot
./bin/hummingbot_quickstart.py

cd <HUMMINGBOT_DIR>
make run

make run ARGS="--config-file-name conf_pure_mm_1.yml"

cd <HUMMINGBOT_DIR>
conda activate hummingbot
pip install build wheel  # if not already installed
python -m build --wheel --no-isolation

pip install dist/hummingbot-*.whl --force-reinstall --no-deps

cd <HUMMINGBOT_DIR>

**Platform wheel suffixes:**
- `linux_x86_64` — Linux AMD/Intel 64-bit
- `linux_aarch64` — Linux ARM64 (Apple Silicon Docker, AWS Graviton)
- `macosx_11_0_arm64` — macOS Apple Silicon (native only, NOT for Docker)
- `macosx_10_9_x86_64` — macOS Intel (native only, NOT for Docker)

cd <HUMMINGBOT_DIR>
docker build -t hummingbot/hummingbot:dev -f Dockerfile .

make build TAG=:dev

docker build -t hummingbot/hummingbot:development -f Dockerfile .

bash scripts/check_env.sh

cd <GATEWAY_DIR>
git fetch origin
git checkout development
git pull origin development

cd <GATEWAY_DIR>
pnpm install

pnpm install --force

pnpm build

undefined

Setup creates:
- `conf/` — chain, connector, token, and RPC configs
- `certs/` — TLS certificates (self-signed for dev)

cd <GATEWAY_DIR>
pnpm start --passphrase=<PASSPHRASE> --dev

pnpm start --passphrase=hummingbot --dev

curl http://localhost:15888/

Gateway listening on port 15888
Solana mainnet-beta initialized
...

undefined

---

cd <GATEWAY_DIR>
docker build \
  --build-arg BRANCH=$(git rev-parse --abbrev-ref HEAD) \
  --build-arg COMMIT=$(git rev-parse HEAD) \
  --build-arg BUILD_DATE=$(date -u +%Y-%m-%dT%H:%M:%SZ) \
  -t hummingbot/gateway:dev \
  -f Dockerfile .

docker tag hummingbot/gateway:dev hummingbot/gateway:development

docker run --rm hummingbot/gateway:dev node -e "console.log('OK')"

cd <HUMMINGBOT_API_DIR>
make install

conda run -n hummingbot-api pip install -e <HUMMINGBOT_DIR> --no-deps

undefined

undefined

conda run -n hummingbot-api python -c "import hummingbot; print(hummingbot.__file__)"

conda run -n hummingbot-api pip install "solders>=0.19.0"

cd <HUMMINGBOT_API_DIR>
docker compose up emqx postgres -d

docker compose ps

cd <HUMMINGBOT_API_DIR>
conda run --no-capture-output -n hummingbot-api uvicorn main:app --reload

make run

curl -s http://localhost:8000/health | python3 -m json.tool

undefined

---

bash scripts/check_api.sh
bash scripts/check_gateway.sh
python scripts/test_integration.py

cd <HUMMINGBOT_DIR>

undefined

cd <HUMMINGBOT_API_DIR>

undefined

cd <HUMMINGBOT_API_DIR>
docker compose -f docker-compose.dev.yml up -d

undefined

---

curl -X POST http://localhost:8000/bot-orchestration/deploy-v2-controllers \
  -u admin:admin \
  -H "Content-Type: application/json" \
  -d '{
    "instance_name": "my-bot",
    "credentials_profile": "master_account",
    "controllers_config": ["my_controller.yml"],
    "image": "hummingbot/hummingbot:development"
  }'

docker run -d --name gateway -p 15888:15888 \
  -e GATEWAY_PASSPHRASE=admin \
  hummingbot/gateway:development

undefined

undefined

undefined

undefined

export HUMMINGBOT_DIR=~/code/hummingbot
export GATEWAY_DIR=~/code/gateway
export HUMMINGBOT_API_DIR=~/code/hummingbot-api