This walkthrough is the fastest way to understand how Hive’s parts fit together. Complete it with disposable example work before connecting production systems.
0–10 minutes: finish setup
- Launch Hive and complete the environment checks.
- Open Models.
- For local use, connect Ollama and pull a model that fits your available memory.
- For cloud use, configure one provider key and verify its live model list.
- Open Settings and confirm the Hive home, authentication, Docker, Git, and GitHub status you intend to use.
Expected result: at least one model is selectable in an agent editor.
10–20 minutes: meet Staff and create an agent
- Open Staff and inspect a recipe-seeded profile.
- Review its role, prompt, skills, tools, memory, suggestions, performance, and history tabs.
- Open Agents → New Agent → Staff profile.
- Select that profile and create its agent.
- Open the agent’s editor and review the inherited runtime settings.
Expected result: the Staff profile has an assigned agent, and the agent card shows a model.
20–30 minutes: chat and refine
- Select Chat on the agent card.
- Give it a small, verifiable request.
- Start a second session for a different topic.
- Ask it to remember one harmless preference.
- Edit the agent, open Memory, and confirm the saved text.
- Update one prompt instruction and retry the original request in a fresh session.
Expected result: you can distinguish conversation history, durable memory, and the system prompt.
30–40 minutes: build a pipeline
- Create a second agent with a different responsibility.
- Open Pipelines → New Pipeline.
- Add a first step using
{input}. - Add a second step using
{prev}. - Review Input Flow Preview.
- Save and run the pipeline manually.
Expected result: the second agent receives the first agent’s output and produces a final result.
40–50 minutes: found a Colony team
- Open Colony and choose a small recipe.
- Found a team with a durable name.
- Review the proposed crew and their Staff profiles.
- Add a narrowly scoped work item.
- Launch and watch blackboard updates and handoffs.
Expected result: you can see the difference between a predetermined pipeline and a role-driven Colony mission.
50–60 minutes: automate safely
- Open Schedules.
- Create a disabled schedule targeting the tested agent or pipeline.
- Write the same prompt that already worked manually.
- Run it once manually and inspect history.
- Decide whether to enable it.
Do not expose a webhook or enable a consequential schedule during the tour.
Where to go next
| Goal | Guide |
|---|---|
| Understand all agent settings | Create and configure an agent |
| Improve agent behavior | Edit and tune an agent |
| Build organizational specialists | Build a Staff member |
| Compose deterministic work | Build a pipeline |
| Coordinate a team | Run a Colony |
| Connect external tools | Connect MCP |