mirror of
https://github.com/hanzoai/bot-hub.git
synced 2026-10-30 18:46:42 +00:00
Every route mounts under /v1/skills, the address api.hanzo.ai routes to this API; auth, personas, users, tokens, upload, integrations, search and whoami are sub-resources and RESERVED keeps them from being slugs. The web, the OG renderers, the CLI's default registry, /.well-known/bothub.json and openapi.json name api.hanzo.ai. Sign-in calls back to api.hanzo.ai/v1/skills/auth/callback and hands the token over in the fragment. The store starts again. docker-entrypoint.sh read Base's port from BASE_PORT, which Kubernetes sets to tcp://<ip>:<port> in a namespace holding a Service named base; Base now listens on 127.0.0.1:8090, fixed. The collections migration is rewritten for the Base the Dockerfile pins (1.5.91): flat field options, declared created/updated, and the users collection every Base already has, extended rather than created twice. Reads are anonymous against public rules, since Base takes IAM credentials only and no longer serves password sign-in; writes answer 503 saying so. The catalogue migration, generated by scripts/catalog.mjs, publishes the 83 skills in hanzoai/bot@8be8f1dc7b. /health reports the store, so the probes restart a pod whose Base is gone. cache.ts decides caching once: an anonymous 2xx GET is public for a minute (five at the edge) with a weak ETag and 304s; a credential, a write or an error is private, no-store. Filter values go through lit(). Embeddings go through api.hanzo.ai and are skipped without a key. k8s/ was a second declaration of the deployment; universe is the one.
bothub
Bot Hub CLI — install, update, search, and publish agent skills as folders.
Install
# From this repo (shortcut script at repo root)
bun bothub --help
# Once published to npm
# npm i -g bothub
Auth (publish)
bothub login
# or
bothub auth login
# Headless / token paste
# or (token paste / headless)
bothub login --token clh_...
Notes:
- Browser login opens
https://hub.hanzo.bot/cli/authand completes via a loopback callback. - Token stored in
~/Library/Application Support/bothub/config.jsonon macOS (override viaBOTHUB_CONFIG_PATH, legacyCLAWDHUB_CONFIG_PATH).
Examples
bothub search "postgres backups"
bothub install my-skill-pack
bothub update --all
bothub update --all --no-input --force
bothub publish ./my-skill-pack --slug my-skill-pack --name "My Skill Pack" --version 1.2.0 --changelog "Fixes + docs"
Sync (upload local skills)
# Start anywhere; scans workdir first, then legacy Clawdis/Clawd/Hanzo Bot/Moltbot locations.
bothub sync
# Explicit roots + non-interactive dry-run
bothub sync --root ../clawdis/skills --all --dry-run
Defaults
- Site:
https://hub.hanzo.bot(override via--siteorBOTHUB_SITE, legacyCLAWDHUB_SITE) - Registry: discovered from
/.well-known/bothub.jsonon the site (legacy/.well-known/bothub.json; override via--registryorBOTHUB_REGISTRY) - Workdir: current directory (falls back to Clawdbot workspace if configured; override via
--workdirorBOTHUB_WORKDIR) - Install dir:
./skillsunder workdir (override via--dir)