Installation
Get up and running with the Hivelang CLI and Bothive Cloud.
Prerequisites
- Node.js 18.0 or later
- A Bothive account (free tier available)
- OpenAI API Key (or other supported LLM provider)
Prefer no install?
You don't need the CLI to build on Bothive. Everything here — creating bots, connecting integrations, scheduled tasks, and deployment works from the dashboard and HiveMind. The CLI is for developers who want version-controlled, file-based agents and local testing. Use whichever fits you.
1. Install the CLI
Install the Hivelang CLI globally using npm. It works on macOS, Linux, and Windows.
Verify it installed by checking the version:
2. Authenticate
Login with your Bothive API key to enable deployments.
Get your API key at: Dashboard → Developer → API Keys
3. Initialize a Project
Create a new bot project with a single command.
CLI Command Reference
| Command | Description |
|---|---|
| hive login | Authenticate with your Bothive account |
| hive logout | Clear stored credentials |
| hive whoami | Show authentication status |
| hive init <name> | Create a new Hivelang bot project |
| hive dev <file> | Run bot in local development mode |
| hive deploy <file> | Deploy your bot to your workspace |
| hive list | List your deployed bots |
| hive integrations | List available standard integrations |
Troubleshooting
"command not found: hive" — your npm global bin isn't on your PATH. Run npm bin -g and add that directory to your PATH, then restart your terminal.
Permission errors on install (EACCES) — avoid sudo; instead set an npm prefix you own, or use a Node version manager like nvm.
Login opens the wrong account — run hive logout then hive login again.
Next step
With the CLI installed and authenticated, build your first agent in the Quick Start — it takes about 5 minutes.